Class Object120

java.lang.Object
  extended by Object120

abstract class Object120
extends java.lang.Object


Constructor Summary
Object120(java.lang.Object... args)
          Automated constructor: Initialize each field of the subclass with the provided args, in the order the fields are declared within the subclass' file.
 
Method Summary
static char charAt(java.lang.String _this, int i)
          Select a single character from a string, by index (starting at 0).
static int charToInt(char c)
          Return the unicode value of a character.
static java.lang.String charToString(char c)
          Convert a char to a String-of-length-1.
static
<T,S extends T>
int
compareTo(java.lang.Comparable<T> _this, S that)
          Check whether one value is greater, equal, or lesser than another.
static boolean contains(java.lang.String _this, java.lang.CharSequence target)
          Return whether or not one String contains another.
static int doubleToInt(double x)
          Convert a double to an int (truncating towards zero).
 boolean equals(java.lang.Object oth)
           
static boolean equals(java.lang.Object _this, java.lang.Object that)
          Are two values equal? Works on any values (non-null).
static boolean equalsIgnoreCase(java.lang.String a, java.lang.String b)
          Are two Strings equal (up to case, but including punctuation).
static java.lang.String getVersion()
          Return the version number of this library (since it might get updated through the semester).
 int hashCode()
           
static int indexOf(java.lang.String _this, java.lang.String target)
          Return where one string is contained inside another.
static char intToChar(int n)
          Return character corresponding to a particular the unicode value.
static double intToDouble(int n)
          Convert an int to a double.
static java.lang.String intToString(int n)
          Convert an int to a String.
static boolean isEmpty(java.lang.String _this)
          Return whether or not a String is the empty string "" (0 letters long).
static int length(java.lang.String _this)
          Return the number of characters in a string.
static void printVersion()
          Print version information to the console window.
static int randomInt(int n)
          Return a random integer in [0,n).
static char stringToChar(java.lang.String s)
          Convert a String-of-length-1 to a char.
static double stringToDouble(java.lang.String s)
          Convert a String to a double.
static int stringToInt(java.lang.String s)
          Convert a String into an int.
static java.lang.String substring(java.lang.String _this, int from)
          Return a substring of the given string from index `from` up through the last character.
static java.lang.String substring(java.lang.String _this, int from, int to)
          Return a substring of the given string, from index `from` up to but not including index `to`.
static java.lang.String toLowerCase(java.lang.String _this)
          Return a lower-case version of the given string.
 java.lang.String toString()
           
 java.lang.String toString(boolean includeFieldNames)
          Return a String which looks like a constructor call:
static java.lang.String toString(java.lang.Object _this)
          Convert any value into a String.
static java.lang.String toUpperCase(java.lang.String _this)
          Return an upper-case version of the given string.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Object120

public Object120(java.lang.Object... args)
Automated constructor: Initialize each field of the subclass with the provided args, in the order the fields are declared within the subclass' file. Remember that if a use writes their own constructor for a subclass, this constructor will still get called first with 0 args, unless the explicitly called `super` with more args. Alas, we can't check here whether they actually manage to initialize their fields correctly...

Method Detail

charAt

public static char charAt(java.lang.String _this,
                          int i)
Select a single character from a string, by index (starting at 0). A static version of `String.charAt(int)`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to select a character from. Cannot be null.
i - The index of the character to select from s; 0 <= i < length(s).
Returns:
The `i`th character of `_this`.
See Also:
String.toLowerCase()

charToInt

public static int charToInt(char c)
Return the unicode value of a character. For "ordinary" characters, this is the ascii value ('A'=43,'B'=44','a'=97,...)

Parameters:
c - The character to get the unicode value of.
Returns:
the unicode value of `c`.
See Also:
http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters

charToString

public static java.lang.String charToString(char c)
Convert a char to a String-of-length-1. Equivalent to calling Character.toString(c), or Object120.toString(c), or new Character(c).toString().

Parameters:
c - The char to convert.
Returns:
c as a String.
See Also:
Character.toString(), toString(Object)

compareTo

public static <T,S extends T> int compareTo(java.lang.Comparable<T> _this,
                                            S that)
Check whether one value is greater, equal, or lesser than another. A static version of compareTo(Object), for use in CS1 before we introduce objects.

Parameters:
_this - The first value to compare.
that - The second value to compare.
Returns:
a positive number if `_this` is greater than `that`, zero if `_this` is equal to `that`, or a negative number if `_this` is less than `that`.
See Also:
Comparable.compareTo(Object)

contains

public static boolean contains(java.lang.String _this,
                               java.lang.CharSequence target)
Return whether or not one String contains another. A static version of `String.contains(CharSequence)`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to look inside of. Cannot be null.
target - The String to look for in `_this`.
Returns:
whether or not `target` occurs in `_this`.
See Also:
String.contains(CharSequence), indexOf(String,String), String.indexOf(String)

doubleToInt

public static int doubleToInt(double x)
Convert a double to an int (truncating towards zero). (Same as casting to an int, but use the regular syntax for calling-a-method.)

Parameters:
x - The double to convert to an int.
Returns:
The int nearest to x, but between 0 and x. For example:
    doubleToInt(0.0) = 0
    doubleToInt(3.1) = 3
    doubleToInt(3.9) = 3
    doubleToInt(-3.1) = -3.0
    doubleToInt(-3.9) = -3.0
    
See Also:
Double.intValue(), Math.floor(double), Math.ceil(double), Math.round(double)

equals

public boolean equals(java.lang.Object oth)
Overrides:
equals in class java.lang.Object

equals

public static boolean equals(java.lang.Object _this,
                             java.lang.Object that)
Are two values equal? Works on any values (non-null). A static version of Object.equals(Object), for use in CS1 before we introduce objects.

Parameters:
_this - the first value to compare. (Must be non-null.)
that - the second value to compare. (Must be non-null.)
Returns:
true iff `_this` equals `_that`. For example:
    equals( "hello", "howdy" ) = false
    equals( "hello", "hello" ) = true
    equals( 23, 22+1 ) = true
See Also:
Object.equals(Object)

equalsIgnoreCase

public static boolean equalsIgnoreCase(java.lang.String a,
                                       java.lang.String b)
Are two Strings equal (up to case, but including punctuation). A static version of String.equalsIgnoreCase(String), for use in CS1 before we introduce objects.

Parameters:
a - The first string to compare. Cannot be null.
b - The second string to compare. Cannot be null.
Returns:
true iff a and b are the same (ignoring case). For example:
   equalsIgnoreCase( "hi", "HI" ) = true
   equalsIgnoreCase( "hi", "hi " ) = false
   equalsIgnoreCase( "", "" ) = true
    
See Also:
String.equalsIgnoreCase(String)

getVersion

public static java.lang.String getVersion()
Return the version number of this library (since it might get updated through the semester).


hashCode

public int hashCode()
Overrides:
hashCode in class java.lang.Object

indexOf

public static int indexOf(java.lang.String _this,
                          java.lang.String target)
Return where one string is contained inside another. A static version of `String.indexOf(String)`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to look inside. Cannot be null.
target - The String to try to find occuring inside `_this`. Cannot be null.
Returns:
The index of `_this` where `target` starts, or -1. That is: if int i=indexOf(s1,s2), then i==-1 || equals(s2,substring(s1,i,i+length(s2))) (equivalently, i==-1 || s2.equals(s1.substring(i,i+s2.length())))
See Also:
String.indexOf(String)

intToChar

public static char intToChar(int n)
Return character corresponding to a particular the unicode value. For "ordinary" characters, this is the ascii value ('A'=43,'B'=44','a'=97,...)

Parameters:
n - The unicode(ascii) value to convert to a char. Must be valid as a short -- in [0,65536).
Returns:
the character corresponding to the unicode value `n`.
See Also:
http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters

intToDouble

public static double intToDouble(int n)
Convert an int to a double. (Same as casting to an int, but use the regular syntax for calling-a-method.)

Parameters:
n - the int to convert.
Returns:
n as a double. For example:
    intToDouble(0) = 0.0
    intToDouble(-2) = -2.0
    intToDouble(2000000000) = 2e9
    intToDouble(2000000001) = 2.000000001e9
    

intToString

public static java.lang.String intToString(int n)
Convert an int to a String.

Parameters:
n - The int to convert to a String.
Returns:
a String representing `n`. For example:
    intToString(0) = "0"
    intToString(-2) = "-2"
    intToString(34) = "34"
    
See Also:
Integer.toString(), Integer.toString(int), toString(Object)

isEmpty

public static boolean isEmpty(java.lang.String _this)
Return whether or not a String is the empty string "" (0 letters long). A static version of `String.isEmpty()`, for use in CS1 before we introduce objects.

Parameters:
_this - The String to compare to "". Cannot be null.
Returns:
whether or not equals(_this,"") (equivalently, length(_this)==0).
See Also:
String.isEmpty()

length

public static int length(java.lang.String _this)
Return the number of characters in a string. A static version of String.length(), for use in CS1 before we introduce objects.

Parameters:
_this - The string to find the length of. Cannot be null.
Returns:
The number of characters in `_this`. For example:
   length( "hi ho" ) = 5
   length( "z" ) = 1
   length( "" ) = 0
    
See Also:
String.length()

printVersion

public static void printVersion()
Print version information to the console window.


randomInt

public static int randomInt(int n)
Return a random integer in [0,n).

Parameters:
n - the top end of the range.
Returns:
a pseudorandom integer in [0,n). E.g. randomInt(100) might return 0 or 1 or 99, but never 100.
See Also:
Random.nextInt(int)

stringToChar

public static char stringToChar(java.lang.String s)
Convert a String-of-length-1 to a char.

Parameters:
s - A string of length 1.
Returns:
s as a char.
See Also:
String.charAt(int)

stringToDouble

public static double stringToDouble(java.lang.String s)
Convert a String to a double.

Parameters:
s - A string which is a valid representation of a double.
Returns:
the double represented by `s`. For example:
    stringToDouble("43.2") = 43.2
    stringToDouble("2") = 2.0
    stringToDouble("007") = 7.0
    
Throws:
java.lang.NumberFormatException - if `s` does not represent a valid double. For example:
    stringToDouble("2+3") -> NumberFormatException
    

stringToInt

public static int stringToInt(java.lang.String s)
Convert a String into an int.

Parameters:
s - A string which is a valid representation of an int; cannot be empty.
Returns:
the int represented by `s`. For example:
    stringToDouble("2") = 2
    stringToDouble("007") = 7
    
Throws:
java.lang.NumberFormatException - if `s` does not represent a valid double. stringToDouble("2+3") throws NumberFormatException

substring

public static java.lang.String substring(java.lang.String _this,
                                         int from)
Return a substring of the given string from index `from` up through the last character. A static version of `String.substring(int)`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to take a substring from. Cannot be null.
start - The index of the first character of the substring.
Returns:
A String consisting from characters at indices [`start`,`length(_this)`) from `_this`.
See Also:
String.substring(int)

substring

public static java.lang.String substring(java.lang.String _this,
                                         int from,
                                         int to)
Return a substring of the given string, from index `from` up to but not including index `to`. A static version of `String.substring(int,int)`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to take a substring from. Cannot be null.
start - The index of the first character of the substring.
stop - The index of the first character after the substring.
Returns:
A String consisting from characters at indices [`start`,`stop`) from `_this`.
See Also:
String.substring(int,int)

toLowerCase

public static java.lang.String toLowerCase(java.lang.String _this)
Return a lower-case version of the given string. A static version of `String.toLowerCase()`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to take a substring from. Cannot be null.
Returns:
A lower-case version of `_this`.
See Also:
String.toLowerCase()

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

toString

public java.lang.String toString(boolean includeFieldNames)
Return a String which looks like a constructor call:

Parameters:
includeFieldNames - If true, include the field names along with their values.
Returns:
a String which looks just like a constructor call when `includeFieldNames` is false, or similar to one when `includeFieldNames` is true. For example:
   class Foo extends Object120 { int n; String s }
   new Foo(7,"hi").toString(false) = "new Foo( 7, \"hi\" )"
   new Foo(8,"ho").toString(true)  = "new Foo( n=8, s=\"ho\" )"
   
Bug: Depending on the Java compiler, the field names might not be given in the same order they are declared in the class. (This is because java.lang.reflect doesn't provide access to the declared order; however, many implementations happen to to use that order.)

toString

public static java.lang.String toString(java.lang.Object _this)
Convert any value into a String. A static version of Object.toString(), for use in CS1 before we introduce objects.

Parameters:
_this - The value to stringify. Cannot be null.
Returns:
a String representation of `_this`. For example:
    toString(43) = "43" 
    toString(true) = "true"
    
See Also:
Object.toString()

toUpperCase

public static java.lang.String toUpperCase(java.lang.String _this)
Return an upper-case version of the given string. A static version of `String.toUpperCase()`, for use in CS1 before we introduce objects.

Parameters:
_this - The `String` to convert to upper case. Cannot be null.
Returns:
An upper-case version of `_this`.
See Also:
String.toUpperCase()