java.lang

Class Short

Implemented Interfaces:
Comparable, Serializable

public final class Short
extends Number
implements Comparable

Instances of class Short represent primitive short values. Additionally, this class provides various helper functions and variables related to shorts.

Since:
1.1

See Also:
Serialized Form

Field Summary

static short
MAX_VALUE
The minimum value a short can represent is 32767 (or 215).
static short
MIN_VALUE
The minimum value a short can represent is -32768 (or -215).
static Class
TYPE
The primitive type short is represented by this Class object.

Constructor Summary

Short(String s)
Create a Short object representing the value of the argument after conversion to a short.
Short(short value)
Create a Short object representing the value of the short argument.

Method Summary

byte
byteValue()
Return the value of this Short as a byte.
int
compareTo(Object o)
Behaves like compareTo(Short) unless the Object is not a Short.
int
compareTo(Short s)
Compare two Shorts numerically by comparing their short values.
static Short
decode(String s)
Convert the specified String into a Short.
double
doubleValue()
Return the value of this Short as a double.
boolean
equals(Object obj)
Returns true if obj is an instance of Short and represents the same short value.
float
floatValue()
Return the value of this Short as a float.
int
hashCode()
Return a hashcode representing this Object.
int
intValue()
Return the value of this Short as an int.
long
longValue()
Return the value of this Short as a long.
static short
parseShort(String s)
Converts the specified String into a short.
static short
parseShort(String s, int radix)
Converts the specified String into a short using the specified radix (base).
short
shortValue()
Return the value of this Short.
String
toString()
Converts the Short value to a String and assumes a radix of 10.
static String
toString(short s)
Converts the short to a String and assumes a radix of 10.
static Short
valueOf(String s)
Creates a new Short object using the String, assuming a radix of 10.
static Short
valueOf(String s, int radix)
Creates a new Short object using the String and specified radix (base).

Methods inherited from class java.lang.Number

byteValue, doubleValue, floatValue, intValue, longValue, shortValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MAX_VALUE

public static final short MAX_VALUE
The minimum value a short can represent is 32767 (or 215).

Field Value:
32767


MIN_VALUE

public static final short MIN_VALUE
The minimum value a short can represent is -32768 (or -215).

Field Value:
-32768


TYPE

public static final Class TYPE
The primitive type short is represented by this Class object.

Constructor Details

Short

public Short(String s)
Create a Short object representing the value of the argument after conversion to a short.

Parameters:
s - the string to convert

Throws:
NumberFormatException - if the String cannot be parsed


Short

public Short(short value)
Create a Short object representing the value of the short argument.

Parameters:
value - the value to use

Method Details

byteValue

public byte byteValue()
Return the value of this Short as a byte.
Overrides:
byteValue in interface Number

Returns:
the byte value


compareTo

public int compareTo(Object o)
Behaves like compareTo(Short) unless the Object is not a Short.
Specified by:
compareTo in interface Comparable

Parameters:
o - the object to compare

Returns:
the comparison

Throws:
ClassCastException - if the argument is not a Short

Since:
1.2

See Also:
compareTo(Short), Comparable


compareTo

public int compareTo(Short s)
Compare two Shorts numerically by comparing their short values. The result is positive if the first is greater, negative if the second is greater, and 0 if the two are equal.

Parameters:
s - the Short to compare

Returns:
the comparison

Since:
1.2


decode

public static Short decode(String s)
Convert the specified String into a Short. The String may represent decimal, hexadecimal, or octal numbers.

The extended BNF grammar is as follows:

 DecodableString:
      ( [ - ] DecimalNumber )
    | ( [ - ] ( 0x | 0X
              | # ) HexDigit { HexDigit } )
    | ( [ - ] 0 { OctalDigit } )
 DecimalNumber:
        DecimalDigit except '0' { DecimalDigit }
 DecimalDigit:
        Character.digit(d, 10) has value 0 to 9
 OctalDigit:
        Character.digit(d, 8) has value 0 to 7
 DecimalDigit:
        Character.digit(d, 16) has value 0 to 15
 
Finally, the value must be in the range MIN_VALUE to MAX_VALUE, or an exception is thrown.

Parameters:
s - the String to interpret

Returns:
the value of the String as a Short

Throws:
NumberFormatException - if s cannot be parsed as a short
NullPointerException - if s is null

See Also:
Integer.decode(String)


doubleValue

public double doubleValue()
Return the value of this Short as a double.
Overrides:
doubleValue in interface Number

Returns:
the double value


equals

public boolean equals(Object obj)
Returns true if obj is an instance of Short and represents the same short value.
Overrides:
equals in interface Object

Parameters:
obj - the object to compare

Returns:
whether these Objects are semantically equal


floatValue

public float floatValue()
Return the value of this Short as a float.
Overrides:
floatValue in interface Number

Returns:
the float value


hashCode

public int hashCode()
Return a hashcode representing this Object. Short's hash code is simply its value.
Overrides:
hashCode in interface Object

Returns:
this Object's hash code


intValue

public int intValue()
Return the value of this Short as an int.
Overrides:
intValue in interface Number

Returns:
the int value


longValue

public long longValue()
Return the value of this Short as a long.
Overrides:
longValue in interface Number

Returns:
the long value


parseShort

public static short parseShort(String s)
Converts the specified String into a short. This function assumes a radix of 10.

Parameters:
s - the String to convert

Returns:
the short value of s

Throws:
NumberFormatException - if s cannot be parsed as a short


parseShort

public static short parseShort(String s,
                               int radix)
Converts the specified String into a short using the specified radix (base). The string must not be null or empty. It may begin with an optional '-', which will negate the answer, provided that there are also valid digits. Each digit is parsed as if by Character.digit(d, radix), and must be in the range 0 to radix - 1. Finally, the result must be within MIN_VALUE to MAX_VALUE, inclusive. Unlike Double.parseDouble, you may not have a leading '+'.

Parameters:
s - the String to convert
radix - the radix (base) to use in the conversion

Returns:
the String argument converted to short

Throws:
NumberFormatException - if s cannot be parsed as a short


shortValue

public short shortValue()
Return the value of this Short.
Overrides:
shortValue in interface Number

Returns:
the short value


toString

public String toString()
Converts the Short value to a String and assumes a radix of 10.
Overrides:
toString in interface Object

Returns:
the String representation of this Short


toString

public static String toString(short s)
Converts the short to a String and assumes a radix of 10.

Parameters:
s - the short to convert to String

Returns:
the String representation of the argument


valueOf

public static Short valueOf(String s)
Creates a new Short object using the String, assuming a radix of 10.

Parameters:
s - the String to convert

Returns:
the new Short

Throws:
NumberFormatException - if s cannot be parsed as a short

See Also:
Short(String), parseShort(String)


valueOf

public static Short valueOf(String s,
                            int radix)
Creates a new Short object using the String and specified radix (base).

Parameters:
s - the String to convert
radix - the radix (base) to convert with

Returns:
the new Short

Throws:
NumberFormatException - if s cannot be parsed as a short

See Also:
parseShort(String,int)


Short.java -- object wrapper for short Copyright (C) 1998, 2001, 2002, 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.