Short represent primitive
- * short values.
- *
- * Additionally, this class provides various helper functions and variables
- * related to shorts.
- *
- * @author Paul Fisher
- * @author John Keiser
- * @since JDK 1.0
- */
-public final class Short extends Number implements Comparable
-{
- static final long serialVersionUID = 7515723908773894738L;
-
- /**
- * The minimum value a short can represent is -32768.
- */
- public static final short MIN_VALUE = -32768;
-
- /**
- * The minimum value a short can represent is 32767.
- */
- public static final short MAX_VALUE = 32767;
-
- /**
- * The primitive type short is represented by this
- * Class object.
- */
- public static final Class TYPE = VMClassLoader.getPrimitiveClass('S');
-
- /**
- * The immutable value of this Short.
- */
- private final short value;
-
- /**
- * Create a Short object representing the value of the
- * short argument.
- *
- * @param value the value to use
- */
- public Short(short value)
- {
- this.value = value;
- }
-
- /**
- * Create a Short object representing the value of the
- * argument after conversion to a short.
- *
- * @param s the string to convert.
- */
- public Short(String s) throws NumberFormatException
- {
- value = parseShort(s, 10);
- }
-
- /**
- * Return a hashcode representing this Object.
- *
- * Short's hash code is calculated by simply returning its
- * value.
- *
- * @return this Object's hash code.
- */
- public int hashCode()
- {
- return value;
- }
-
- /**
- * If the Object is not null, is an
- * instanceof Short, and represents
- * the same primitive short value return
- * true. Otherwise false is returned.
- */
- public boolean equals(Object obj)
- {
- return obj instanceof Short && ((Short)obj).value == value;
- }
-
- /**
- * Converts the short to a String and assumes
- * a radix of 10.
- * @param i the short to convert to String
- * @return the String representation of the argument.
- */
- public static String toString(short i)
- {
- return Integer.toString((int) i);
- }
-
- /**
- * Converts the Short value to a String and
- * assumes a radix of 10.
- * @return the String representation of this Short.
- */
- public String toString()
- {
- return Integer.toString ((int) value);
- }
-
- /**
- * Creates a new Short object using the String,
- * assuming a radix of 10.
- * @param s the String to convert.
- * @return the new Short.
- * @see #Short(java.lang.String)
- * @see #parseShort(java.lang.String)
- * @exception NumberFormatException thrown if the String
- * cannot be parsed as a short.
- */
- public static Short valueOf(String s) throws NumberFormatException
- {
- return new Short(parseShort(s));
- }
-
- /**
- * Creates a new Short object using the String
- * and specified radix (base).
- * @param s the String to convert.
- * @param radix the radix (base) to convert with.
- * @return the new Short.
- * @see #parseShort(java.lang.String,int)
- * @exception NumberFormatException thrown if the String
- * cannot be parsed as a short.
- */
- public static Short valueOf(String s, int radix)
- throws NumberFormatException
- {
- return new Short(parseShort(s, radix));
- }
-
- /**
- * Converts the specified String into a short.
- * This function assumes a radix of 10.
- *
- * @param s the String to convert
- * @return the short value of the String
- * argument.
- * @exception NumberFormatException thrown if the String
- * cannot be parsed as a short.
- */
- public static short parseShort(String s) throws NumberFormatException
- {
- return parseShort(s, 10);
- }
-
- /**
- * Converts the specified String into a short
- * using the specified radix (base).
- *
- * @param s the String to convert
- * @param radix the radix (base) to use in the conversion
- * @return the String argument converted to short.
- * @exception NumberFormatException thrown if the String
- * cannot be parsed as a short.
- */
- public static short parseShort(String s, int radix)
- throws NumberFormatException
- {
- int i = Integer.parseInt(s, radix);
- if (i < MIN_VALUE || i > MAX_VALUE)
- throw new NumberFormatException();
- return (short) i;
- }
-
- /**
- * Convert the specified String into a Short.
- * The String may represent decimal, hexadecimal, or
- * octal numbers.
- *
- * The String argument is interpreted based on the leading
- * characters. Depending on what the String begins with, the base will be
- * interpreted differently:
- *
- * | Leading Characters | Base |
|---|---|
| # | 16 |
| 0x | 16 |
| 0X | 16 |
| 0 | 8 |
| Anything Else | 10 |
String to interpret.
- * @return the value of the String as a Short.
- * @exception NumberFormatException thrown if the String
- * cannot be parsed as a short.
- */
- public static Short decode(String s) throws NumberFormatException
- {
- int i = (Integer.decode(s)).intValue();
- if (i < MIN_VALUE || i > MAX_VALUE)
- throw new NumberFormatException();
- return new Short((short) i);
- }
-
- /** Return the value of this Short as an short.
- ** @return the value of this Short as an short.
- **/
- public byte byteValue()
- {
- return (byte) value;
- }
-
- /** Return the value of this Short as an short.
- ** @return the value of this Short as an short.
- **/
- public short shortValue()
- {
- return value;
- }
-
- /** Return the value of this Short as an int.
- ** @return the value of this Short as an int.
- **/
- public int intValue()
- {
- return value;
- }
-
- /** Return the value of this Short as a long.
- ** @return the value of this Short as a long.
- **/
- public long longValue()
- {
- return value;
- }
-
- /** Return the value of this Short as a float.
- ** @return the value of this Short as a float.
- **/
- public float floatValue()
- {
- return value;
- }
-
- /** Return the value of this Short as a double.
- ** @return the value of this Short as a double.
- **/
- public double doubleValue()
- {
- return value;
- }
-
- /**
- * Compare two Shorts numerically by comparing their
- * short values.
- * @return a positive value if this Short is greater
- * in value than the argument Short; a negative value
- * if this Short is smaller in value than the argument
- * Short; and 0, zero, if this
- * Short is equal in value to the argument
- * Short.
- *
- * @since 1.2
- */
- public int compareTo(Short s)
- {
- return value - s.value;
- }
-
- /**
- * Behaves like compareTo(java.lang.Short) unless the Object
- * is not a Short. Then it throws a
- * ClassCastException.
- * @exception ClassCastException if the argument is not a
- * Short.
- *
- * @since 1.2
- */
- public int compareTo(Object o)
- {
- return compareTo((Short)o);
- }
-}