Package java.lang
Class Short
- java.lang.Object
-
- java.lang.Number
-
- java.lang.Short
-
- All Implemented Interfaces:
Serializable
,Comparable<Short>
,Modified
public final class Short extends Number implements Comparable<Short>, Modified
The wrapper for the primitive typeshort
.- Since:
- 1.1
- See Also:
Number
, Serialized Form
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description byte
byteValue()
Returns this object's value as a byte.static int
compare(short lhs, short rhs)
Compares twoshort
values.int
compareTo(Short object)
Compares this object to the specified short object to determine their relative order.static Short
decode(String string)
Parses the specified string and returns aShort
instance if the string can be decoded into a short value.double
doubleValue()
Returns this object's value as a double.boolean
equals(Object object)
Compares this instance with the specified object and indicates if they are equal.float
floatValue()
Returns this object's value as a float.int
hashCode()
Returns an integer hash code for this object.int
intValue()
Returns this object's value as an int.long
longValue()
Returns this object's value as a long.static short
parseShort(String string)
Parses the specified string as a signed decimal short value.static short
parseShort(String string, int radix)
Parses the specified string as a signed short value using the specified radix.static short
reverseBytes(short s)
Reverses the bytes of the specified short.short
shortValue()
Gets the primitive value of this short.String
toString()
Returns a string containing a concise, human-readable description of this object.static String
toString(short value)
Returns a string containing a concise, human-readable description of the specified short value with radix 10.static Short
valueOf(short s)
Returns aShort
instance for the specified short value.static Short
valueOf(String string)
Parses the specified string as a signed decimal short value.static Short
valueOf(String string, int radix)
Parses the specified string as a signed short value using the specified radix.
-
-
-
Field Detail
-
MAX_VALUE
public static final short MAX_VALUE
Constant for the maximumshort
value, 215-1.- See Also:
- Constant Field Values
-
MIN_VALUE
public static final short MIN_VALUE
Constant for the minimumshort
value, -215.- See Also:
- Constant Field Values
-
SIZE
public static final int SIZE
Constant for the number of bits needed to represent ashort
in two's complement form.- Since:
- 1.5
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Short
public Short(String string) throws NumberFormatException
Constructs a newShort
from the specified string.- Parameters:
string
- the string representation of a short value.- Throws:
NumberFormatException
- ifstring
cannot be parsed as a short value.- See Also:
parseShort(String)
-
Short
public Short(short value)
Constructs a newShort
with the specified primitive short value.- Parameters:
value
- the primitive short value to store in the new instance.
-
-
Method Detail
-
byteValue
public byte byteValue()
Description copied from class:Number
Returns this object's value as a byte. Might involve rounding and/or truncating the value, so it fits into a byte.
-
compareTo
public int compareTo(Short object)
Compares this object to the specified short object to determine their relative order.- Specified by:
compareTo
in interfaceComparable<Short>
- Parameters:
object
- the short object to compare this object to.- Returns:
- a negative value if the value of this short is less than the
value of
object
; 0 if the value of this short and the value ofobject
are equal; a positive value if the value of this short is greater than the value ofobject
. - Throws:
NullPointerException
- ifobject
is null.- Since:
- 1.2
- See Also:
Comparable
-
compare
public static int compare(short lhs, short rhs)
Compares twoshort
values.- Parameters:
lhs
- First value.rhs
- Second value.- Returns:
- 0 if lhs = rhs, less than 0 if lhs < rhs, and greater than 0 if lhs > rhs.
- Since:
- 1.7
-
decode
public static Short decode(String string) throws NumberFormatException
Parses the specified string and returns aShort
instance if the string can be decoded into a short value. The string may be an optional minus sign "-" followed by a hexadecimal ("0x..." or "#..."), octal ("0..."), or decimal ("...") representation of a short.- Parameters:
string
- a string representation of a short value.- Returns:
- a
Short
containing the value represented bystring
. - Throws:
NumberFormatException
- ifstring
cannot be parsed as a short value.
-
doubleValue
public double doubleValue()
Description copied from class:Number
Returns this object's value as a double. Might involve rounding.- Specified by:
doubleValue
in classNumber
- Returns:
- the primitive double value of this object.
-
equals
public boolean equals(Object object)
Compares this instance with the specified object and indicates if they are equal. In order to be equal,object
must be an instance ofShort
and have the same short value as this object.- Overrides:
equals
in classObject
- Parameters:
object
- the object to compare this short with.- Returns:
true
if the specified object is equal to thisShort
;false
otherwise.- See Also:
Object.hashCode()
-
floatValue
public float floatValue()
Description copied from class:Number
Returns this object's value as a float. Might involve rounding.- Specified by:
floatValue
in classNumber
- Returns:
- the primitive float value of this object.
-
hashCode
public int hashCode()
Description copied from class:Object
Returns an integer hash code for this object. By contract, any two objects for whichObject.equals(java.lang.Object)
returnstrue
must return the same hash code value. This means that subclasses ofObject
usually override both methods or neither method.Note that hash values must not change over time unless information used in equals comparisons also changes.
See Writing a correct
hashCode
method if you intend implementing your ownhashCode
method.- Overrides:
hashCode
in classObject
- Returns:
- this object's hash code.
- See Also:
Object.equals(java.lang.Object)
-
intValue
public int intValue()
Description copied from class:Number
Returns this object's value as an int. Might involve rounding and/or truncating the value, so it fits into an int.
-
longValue
public long longValue()
Description copied from class:Number
Returns this object's value as a long. Might involve rounding and/or truncating the value, so it fits into a long.
-
parseShort
public static short parseShort(String string) throws NumberFormatException
Parses the specified string as a signed decimal short value. The ASCII character - ('-') is recognized as the minus sign.- Parameters:
string
- the string representation of a short value.- Returns:
- the primitive short value represented by
string
. - Throws:
NumberFormatException
- ifstring
cannot be parsed as a short value.
-
parseShort
public static short parseShort(String string, int radix) throws NumberFormatException
Parses the specified string as a signed short value using the specified radix. The ASCII character - ('-') is recognized as the minus sign.- Parameters:
string
- the string representation of a short value.radix
- the radix to use when parsing.- Returns:
- the primitive short value represented by
string
usingradix
. - Throws:
NumberFormatException
- ifstring
cannot be parsed as a short value, orradix < Character.MIN_RADIX || radix > Character.MAX_RADIX
.
-
shortValue
public short shortValue()
Gets the primitive value of this short.- Overrides:
shortValue
in classNumber
- Returns:
- this object's primitive value.
-
toString
public String toString()
Description copied from class:Object
Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data.
-
toString
public static String toString(short value)
Returns a string containing a concise, human-readable description of the specified short value with radix 10.- Parameters:
value
- the short to convert to a string.- Returns:
- a printable representation of
value
.
-
valueOf
public static Short valueOf(String string) throws NumberFormatException
Parses the specified string as a signed decimal short value.- Parameters:
string
- the string representation of a short value.- Returns:
- a
Short
instance containing the short value represented bystring
. - Throws:
NumberFormatException
- ifstring
cannot be parsed as a short value.- See Also:
parseShort(String)
-
valueOf
public static Short valueOf(String string, int radix) throws NumberFormatException
Parses the specified string as a signed short value using the specified radix.- Parameters:
string
- the string representation of a short value.radix
- the radix to use when parsing.- Returns:
- a
Short
instance containing the short value represented bystring
usingradix
. - Throws:
NumberFormatException
- ifstring
cannot be parsed as a short value, orradix < Character.MIN_RADIX || radix > Character.MAX_RADIX
.- See Also:
parseShort(String, int)
-
reverseBytes
public static short reverseBytes(short s)
Reverses the bytes of the specified short.- Parameters:
s
- the short value for which to reverse bytes.- Returns:
- the reversed value.
- Since:
- 1.5
-
valueOf
public static Short valueOf(short s)
Returns aShort
instance for the specified short value.If it is not necessary to get a new
Short
instance, it is recommended to use this method instead of the constructor, since it maintains a cache of instances which may result in better performance.- Parameters:
s
- the short value to store in the instance.- Returns:
- a
Short
instance containings
. - Since:
- 1.5
-
-