Class Short
 All Implemented Interfaces:
Serializable
,Comparable<Short>
,Constable
Short
class is the wrapper class for values of the primitive
type short
. An object of type Short
contains a
single field whose type is short
.
In addition, this class provides several methods for converting
a short
to a String
and a String
to a
short
, as well as other constants and methods useful when
dealing with a short
.
This is a valuebased class; programmers should treat instances that are equal as interchangeable and should not use instances for synchronization, or unpredictable behavior may occur. For example, in a future release, synchronization may fail.
 Since:
 1.1
 See Also:

Field Summary
Modifier and TypeFieldDescriptionstatic final int
The number of bytes used to represent ashort
value in two's complement binary form.static final short
A constant holding the maximum value ashort
can have, 2^{15}1.static final short
A constant holding the minimum value ashort
can have, 2^{15}.static final int
The number of bits used to represent ashort
value in two's complement binary form.TheClass
instance representing the primitive typeshort
. 
Constructor Summary
ConstructorDescriptionShort
(short value) Deprecated, for removal: This API element is subject to removal in a future version.It is rarely appropriate to use this constructor.Deprecated, for removal: This API element is subject to removal in a future version.It is rarely appropriate to use this constructor. 
Method Summary
Modifier and TypeMethodDescriptionbyte
Returns the value of thisShort
as abyte
after a narrowing primitive conversion.static int
compare
(short x, short y) Compares twoshort
values numerically.int
Compares twoShort
objects numerically.static int
compareUnsigned
(short x, short y) Compares twoshort
values numerically treating the values as unsigned.static Short
Decodes aString
into aShort
.Returns anOptional
containing the nominal descriptor for this instance.double
Returns the value of thisShort
as adouble
after a widening primitive conversion.boolean
Compares this object to the specified object.float
Returns the value of thisShort
as afloat
after a widening primitive conversion.int
hashCode()
Returns a hash code for thisShort
; equal to the result of invokingintValue()
.static int
hashCode
(short value) Returns a hash code for ashort
value; compatible withShort.hashCode()
.int
intValue()
Returns the value of thisShort
as anint
after a widening primitive conversion.long
Returns the value of thisShort
as along
after a widening primitive conversion.static short
parseShort
(String s) Parses the string argument as a signed decimalshort
.static short
parseShort
(String s, int radix) Parses the string argument as a signedshort
in the radix specified by the second argument.static short
reverseBytes
(short i) Returns the value obtained by reversing the order of the bytes in the two's complement representation of the specifiedshort
value.short
Returns the value of thisShort
as ashort
.toString()
Returns aString
object representing thisShort
's value.static String
toString
(short s) Returns a newString
object representing the specifiedshort
.static int
toUnsignedInt
(short x) Converts the argument to anint
by an unsigned conversion.static long
toUnsignedLong
(short x) Converts the argument to along
by an unsigned conversion.static Short
valueOf
(short s) Returns aShort
instance representing the specifiedshort
value.static Short
Returns aShort
object holding the value given by the specifiedString
.static Short
Returns aShort
object holding the value extracted from the specifiedString
when parsed with the radix given by the second argument.

Field Details

MIN_VALUE
public static final short MIN_VALUEA constant holding the minimum value ashort
can have, 2^{15}. See Also:

MAX_VALUE
public static final short MAX_VALUEA constant holding the maximum value ashort
can have, 2^{15}1. See Also:

TYPE

SIZE
public static final int SIZEThe number of bits used to represent ashort
value in two's complement binary form. Since:
 1.5
 See Also:

BYTES
public static final int BYTESThe number of bytes used to represent ashort
value in two's complement binary form. Since:
 1.8
 See Also:


Constructor Details

Short
Deprecated, for removal: This API element is subject to removal in a future version.It is rarely appropriate to use this constructor. The static factoryvalueOf(short)
is generally a better choice, as it is likely to yield significantly better space and time performance.Constructs a newly allocatedShort
object that represents the specifiedshort
value. Parameters:
value
 the value to be represented by theShort
.

Short
Deprecated, for removal: This API element is subject to removal in a future version.It is rarely appropriate to use this constructor. UseparseShort(String)
to convert a string to ashort
primitive, or usevalueOf(String)
to convert a string to aShort
object.Constructs a newly allocatedShort
object that represents theshort
value indicated by theString
parameter. The string is converted to ashort
value in exactly the manner used by theparseShort
method for radix 10. Parameters:
s
 theString
to be converted to aShort
 Throws:
NumberFormatException
 If theString
does not contain a parsableshort
.


Method Details

toString
Returns a newString
object representing the specifiedshort
. The radix is assumed to be 10. Parameters:
s
 theshort
to be converted Returns:
 the string representation of the specified
short
 See Also:

parseShort
Parses the string argument as a signedshort
in the radix specified by the second argument. The characters in the string must all be digits, of the specified radix (as determined by whetherCharacter.digit(char, int)
returns a nonnegative value) except that the first character may be an ASCII minus sign''
('\u002D'
) to indicate a negative value or an ASCII plus sign'+'
('\u002B'
) to indicate a positive value. The resultingshort
value is returned.An exception of type
NumberFormatException
is thrown if any of the following situations occurs: The first argument is
null
or is a string of length zero.  The radix is either smaller than
Character.MIN_RADIX
or larger thanCharacter.MAX_RADIX
.  Any character of the string is not a digit of the
specified radix, except that the first character may be a minus
sign
''
('\u002D'
) or plus sign'+'
('\u002B'
) provided that the string is longer than length 1.  The value represented by the string is not a value of type
short
.
 Parameters:
s
 theString
containing theshort
representation to be parsedradix
 the radix to be used while parsings
 Returns:
 the
short
represented by the string argument in the specified radix.  Throws:
NumberFormatException
 If theString
does not contain a parsableshort
.
 The first argument is

parseShort
Parses the string argument as a signed decimalshort
. The characters in the string must all be decimal digits, except that the first character may be an ASCII minus sign''
('\u002D'
) to indicate a negative value or an ASCII plus sign'+'
('\u002B'
) to indicate a positive value. The resultingshort
value is returned, exactly as if the argument and the radix 10 were given as arguments to theparseShort(java.lang.String, int)
method. Parameters:
s
 aString
containing theshort
representation to be parsed Returns:
 the
short
value represented by the argument in decimal.  Throws:
NumberFormatException
 If the string does not contain a parsableshort
.

valueOf
Returns aShort
object holding the value extracted from the specifiedString
when parsed with the radix given by the second argument. The first argument is interpreted as representing a signedshort
in the radix specified by the second argument, exactly as if the argument were given to theparseShort(java.lang.String, int)
method. The result is aShort
object that represents theshort
value specified by the string.In other words, this method returns a
Short
object equal to the value of:Short.valueOf(Short.parseShort(s, radix))
 Parameters:
s
 the string to be parsedradix
 the radix to be used in interpretings
 Returns:
 a
Short
object holding the value represented by the string argument in the specified radix.  Throws:
NumberFormatException
 If theString
does not contain a parsableshort
.

valueOf
Returns aShort
object holding the value given by the specifiedString
. The argument is interpreted as representing a signed decimalshort
, exactly as if the argument were given to theparseShort(java.lang.String)
method. The result is aShort
object that represents theshort
value specified by the string.In other words, this method returns a
Short
object equal to the value of:Short.valueOf(Short.parseShort(s))
 Parameters:
s
 the string to be parsed Returns:
 a
Short
object holding the value represented by the string argument  Throws:
NumberFormatException
 If theString
does not contain a parsableshort
.

describeConstable
Returns anOptional
containing the nominal descriptor for this instance. Specified by:
describeConstable
in interfaceConstable
 Returns:
 an
Optional
describing the Short instance  Since:
 15

valueOf
Returns aShort
instance representing the specifiedshort
value. If a newShort
instance is not required, this method should generally be used in preference to the constructorShort(short)
, as this method is likely to yield significantly better space and time performance by caching frequently requested values. This method will always cache values in the range 128 to 127, inclusive, and may cache other values outside of this range. Parameters:
s
 a short value. Returns:
 a
Short
instance representings
.  Since:
 1.5

decode
Decodes aString
into aShort
. Accepts decimal, hexadecimal, and octal numbers given by the following grammar: DecodableString:
 Sign_{opt} DecimalNumeral
 Sign_{opt}
0x
HexDigits  Sign_{opt}
0X
HexDigits  Sign_{opt}
#
HexDigits  Sign_{opt}
0
OctalDigits  Sign:

+
The sequence of characters following an optional sign and/or radix specifier ("
0x
", "0X
", "#
", or leading zero) is parsed as by theShort.parseShort
method with the indicated radix (10, 16, or 8). This sequence of characters must represent a positive value or aNumberFormatException
will be thrown. The result is negated if first character of the specifiedString
is the minus sign. No whitespace characters are permitted in theString
. Parameters:
nm
 theString
to decode. Returns:
 a
Short
object holding theshort
value represented bynm
 Throws:
NumberFormatException
 if theString
does not contain a parsableshort
. See Also:

byteValue
public byte byteValue()Returns the value of thisShort
as abyte
after a narrowing primitive conversion. Overrides:
byteValue
in classNumber
 Returns:
 the numeric value represented by this object after conversion
to type
byte
.  See Java Language Specification:

5.1.3 Narrowing Primitive Conversion

shortValue
public short shortValue()Returns the value of thisShort
as ashort
. Overrides:
shortValue
in classNumber
 Returns:
 the numeric value represented by this object after conversion
to type
short
.

intValue
public int intValue()Returns the value of thisShort
as anint
after a widening primitive conversion. Specified by:
intValue
in classNumber
 Returns:
 the numeric value represented by this object after conversion
to type
int
.  See Java Language Specification:

5.1.2 Widening Primitive Conversion

longValue
public long longValue()Returns the value of thisShort
as along
after a widening primitive conversion. Specified by:
longValue
in classNumber
 Returns:
 the numeric value represented by this object after conversion
to type
long
.  See Java Language Specification:

5.1.2 Widening Primitive Conversion

floatValue
public float floatValue()Returns the value of thisShort
as afloat
after a widening primitive conversion. Specified by:
floatValue
in classNumber
 Returns:
 the numeric value represented by this object after conversion
to type
float
.  See Java Language Specification:

5.1.2 Widening Primitive Conversion

doubleValue
public double doubleValue()Returns the value of thisShort
as adouble
after a widening primitive conversion. Specified by:
doubleValue
in classNumber
 Returns:
 the numeric value represented by this object after conversion
to type
double
.  See Java Language Specification:

5.1.2 Widening Primitive Conversion

toString
Returns aString
object representing thisShort
's value. The value is converted to signed decimal representation and returned as a string, exactly as if theshort
value were given as an argument to thetoString(short)
method. 
hashCode

hashCode
public static int hashCode(short value) Returns a hash code for ashort
value; compatible withShort.hashCode()
. Parameters:
value
 the value to hash Returns:
 a hash code value for a
short
value.  Since:
 1.8

equals
Compares this object to the specified object. The result istrue
if and only if the argument is notnull
and is aShort
object that contains the sameshort
value as this object. 
compareTo
Compares twoShort
objects numerically. Specified by:
compareTo
in interfaceComparable<Short>
 Parameters:
anotherShort
 theShort
to be compared. Returns:
 the value
0
if thisShort
is equal to the argumentShort
; a value less than0
if thisShort
is numerically less than the argumentShort
; and a value greater than0
if thisShort
is numerically greater than the argumentShort
(signed comparison).  Since:
 1.2

compare
public static int compare(short x, short y) Compares twoshort
values numerically. The value returned is identical to what would be returned by:Short.valueOf(x).compareTo(Short.valueOf(y))
 Parameters:
x
 the firstshort
to comparey
 the secondshort
to compare Returns:
 the value
0
ifx == y
; a value less than0
ifx < y
; and a value greater than0
ifx > y
 Since:
 1.7

compareUnsigned
public static int compareUnsigned(short x, short y) Compares twoshort
values numerically treating the values as unsigned. Parameters:
x
 the firstshort
to comparey
 the secondshort
to compare Returns:
 the value
0
ifx == y
; a value less than0
ifx < y
as unsigned values; and a value greater than0
ifx > y
as unsigned values  Since:
 9

reverseBytes
public static short reverseBytes(short i) Returns the value obtained by reversing the order of the bytes in the two's complement representation of the specifiedshort
value. Parameters:
i
 the value whose bytes are to be reversed Returns:
 the value obtained by reversing (or, equivalently, swapping)
the bytes in the specified
short
value.  Since:
 1.5

toUnsignedInt
public static int toUnsignedInt(short x) Converts the argument to anint
by an unsigned conversion. In an unsigned conversion to anint
, the highorder 16 bits of theint
are zero and the loworder 16 bits are equal to the bits of theshort
argument. Consequently, zero and positiveshort
values are mapped to a numerically equalint
value and negativeshort
values are mapped to anint
value equal to the input plus 2^{16}. Parameters:
x
 the value to convert to an unsignedint
 Returns:
 the argument converted to
int
by an unsigned conversion  Since:
 1.8

toUnsignedLong
public static long toUnsignedLong(short x) Converts the argument to along
by an unsigned conversion. In an unsigned conversion to along
, the highorder 48 bits of thelong
are zero and the loworder 16 bits are equal to the bits of theshort
argument. Consequently, zero and positiveshort
values are mapped to a numerically equallong
value and negativeshort
values are mapped to along
value equal to the input plus 2^{16}. Parameters:
x
 the value to convert to an unsignedlong
 Returns:
 the argument converted to
long
by an unsigned conversion  Since:
 1.8
