Class Short
- java.lang.Object
-
- java.lang.Number
-
- java.lang.Short
- All Implemented Interfaces:
-
Serializable
,Comparable<Short>
public final class Short extends Number implements Comparable<Short>
The Short
class wraps a value of primitive type
short
in an object. 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
.
- Since:
- 1.1
- See Also:
-
Number
, Serialized Form
Field Summary
Modifier and Type | Field | Description |
---|---|---|
static int | BYTES | The number of bytes used to represent a |
static short | MAX_VALUE | A constant holding the maximum value a |
static short | MIN_VALUE | A constant holding the minimum value a |
static int | SIZE | The number of bits used to represent a |
static Class<Short> | TYPE | The |
Constructor Summary
Constructor | Description |
---|---|
Short(short value) | Deprecated. It is rarely appropriate to use this constructor. |
Short(String s) | Deprecated. It is rarely appropriate to use this constructor. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
byte | byteValue() | Returns the value of this |
static int | compare(short x,
short y) | Compares two |
int | compareTo(Short anotherShort) | Compares two |
static int | compareUnsigned(short x,
short y) | Compares two |
static Short | decode(String nm) | Decodes a |
double | doubleValue() | Returns the value of this |
boolean | equals(Object obj) | Compares this object to the specified object. |
float | floatValue() | Returns the value of this |
int | hashCode() | Returns a hash code for this |
static int | hashCode(short value) | Returns a hash code for a |
int | intValue() | Returns the value of this |
long | longValue() | Returns the value of this |
static short | parseShort(String s) | Parses the string argument as a signed decimal |
static short | parseShort(String s,
int radix) | Parses the string argument as a signed |
static short | reverseBytes(short i) | Returns the value obtained by reversing the order of the bytes in the two's complement representation of the specified |
short | shortValue() | Returns the value of this |
String | toString() | Returns a |
static String | toString(short s) | Returns a new |
static int | toUnsignedInt(short x) | Converts the argument to an |
static long | toUnsignedLong(short x) | Converts the argument to a |
static Short | valueOf(short s) | Returns a |
static Short | valueOf(String s) | Returns a |
static Short | valueOf(String s,
int radix) | Returns a |
Methods declared in class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Field Detail
MIN_VALUE
public static final short MIN_VALUE
A constant holding the minimum value a short
can have, -215.
- See Also:
- Constant Field Values
MAX_VALUE
public static final short MAX_VALUE
A constant holding the maximum value a short
can have, 215-1.
- See Also:
- Constant Field Values
TYPE
public static final Class<Short> TYPE
The Class
instance representing the primitive type short
.
SIZE
public static final int SIZE
The number of bits used to represent a short
value in two's complement binary form.
- Since:
- 1.5
- See Also:
- Constant Field Values
BYTES
public static final int BYTES
The number of bytes used to represent a short
value in two's complement binary form.
- Since:
- 1.8
- See Also:
- Constant Field Values
Constructor Detail
Short
@Deprecated(since="9") public Short(short value)
valueOf(short)
is generally a better choice, as it is likely to yield significantly better space and time performance.Constructs a newly allocated Short
object that represents the specified short
value.
- Parameters:
-
value
- the value to be represented by theShort
.
Short
@Deprecated(since="9") public Short(String s) throws NumberFormatException
parseShort(String)
to convert a string to a short
primitive, or use valueOf(String)
to convert a string to a Short
object.Constructs a newly allocated Short
object that represents the short
value indicated by the String
parameter. The string is converted to a short
value in exactly the manner used by the parseShort
method for radix 10.
- Parameters:
-
s
- theString
to be converted to aShort
- Throws:
-
NumberFormatException
- If theString
does not contain a parsableshort
.
Method Detail
toString
public static String toString(short s)
Returns a new String
object representing the specified short
. The radix is assumed to be 10.
- Parameters:
-
s
- theshort
to be converted - Returns:
- the string representation of the specified
short
- See Also:
Integer.toString(int)
parseShort
public static short parseShort(String s, int radix) throws NumberFormatException
Parses the string argument as a signed short
in the radix specified by the second argument. The characters in the string must all be digits, of the specified radix (as determined by whether Character.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 resulting short
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 parsed -
radix
- 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
.
parseShort
public static short parseShort(String s) throws NumberFormatException
Parses the string argument as a signed decimal
short
. 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 resulting short
value is returned, exactly as if the argument and the radix 10 were given as arguments to the parseShort(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
public static Short valueOf(String s, int radix) throws NumberFormatException
Returns a Short
object holding the value extracted from the specified String
when parsed with the radix given by the second argument. The first argument is interpreted as representing a signed short
in the radix specified by the second argument, exactly as if the argument were given to the parseShort(java.lang.String,
int)
method. The result is a Short
object that represents the short
value specified by the string.
In other words, this method returns a Short
object equal to the value of:
new Short(Short.parseShort(s, radix))
- Parameters:
-
s
- the string to be parsed -
radix
- 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
public static Short valueOf(String s) throws NumberFormatException
Returns a Short
object holding the value given by the specified String
. The argument is interpreted as representing a signed decimal short
, exactly as if the argument were given to the parseShort(java.lang.String)
method. The result is a Short
object that represents the short
value specified by the string.
In other words, this method returns a Short
object equal to the value of:
new Short(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
.
valueOf
public static Short valueOf(short s)
Returns a Short
instance representing the specified short
value. If a new Short
instance is not required, this method should generally be used in preference to the constructor Short(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
public static Short decode(String nm) throws NumberFormatException
Decodes a String
into a Short
. Accepts decimal, hexadecimal, and octal numbers given by the following grammar:
- DecodableString:
-
Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits - Signopt
- Sign:
-
-
+
The sequence of characters following an optional sign and/or radix specifier ("0x
", "0X
", "#
", or leading zero) is parsed as by the
Short.parseShort
method with the indicated radix (10, 16, or 8). This sequence of characters must represent a positive value or a NumberFormatException
will be thrown. The result is negated if first character of the specified
String
is the minus sign. No whitespace characters are permitted in the String
.
- 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:
parseShort(java.lang.String, int)
byteValue
public byte byteValue()
Returns the value of this Short
as a byte
after a narrowing primitive conversion.
- Overrides:
-
byteValue
in classNumber
- Returns:
- the numeric value represented by this object after conversion to type
byte
.
shortValue
public short shortValue()
Returns the value of this Short
as a short
.
- 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 this Short
as an int
after a widening primitive conversion.
- Specified by:
-
intValue
in classNumber
- Returns:
- the numeric value represented by this object after conversion to type
int
.
longValue
public long longValue()
Returns the value of this Short
as a long
after a widening primitive conversion.
- Specified by:
-
longValue
in classNumber
- Returns:
- the numeric value represented by this object after conversion to type
long
.
floatValue
public float floatValue()
Returns the value of this Short
as a float
after a widening primitive conversion.
- Specified by:
-
floatValue
in classNumber
- Returns:
- the numeric value represented by this object after conversion to type
float
.
doubleValue
public double doubleValue()
Returns the value of this Short
as a double
after a widening primitive conversion.
- Specified by:
-
doubleValue
in classNumber
- Returns:
- the numeric value represented by this object after conversion to type
double
.
toString
public String toString()
Returns a String
object representing this Short
's value. The value is converted to signed decimal representation and returned as a string, exactly as if the short
value were given as an argument to the toString(short)
method.
- Overrides:
-
toString
in classObject
- Returns:
- a string representation of the value of this object in base 10.
hashCode
public int hashCode()
Returns a hash code for this Short
; equal to the result of invoking intValue()
.
- Overrides:
-
hashCode
in classObject
- Returns:
- a hash code value for this
Short
- See Also:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
hashCode
public static int hashCode(short value)
Returns a hash code for a short
value; compatible with Short.hashCode()
.
- Parameters:
-
value
- the value to hash - Returns:
- a hash code value for a
short
value. - Since:
- 1.8
equals
public boolean equals(Object obj)
Compares this object to the specified object. The result is true
if and only if the argument is not null
and is a Short
object that contains the same short
value as this object.
- Overrides:
-
equals
in classObject
- Parameters:
-
obj
- the object to compare with - Returns:
-
true
if the objects are the same;false
otherwise. - See Also:
-
Object.hashCode()
,HashMap
compareTo
public int compareTo(Short anotherShort)
Compares two Short
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 two short
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 compare -
y
- 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 two short
values numerically treating the values as unsigned.
- Parameters:
-
x
- the firstshort
to compare -
y
- 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 specified short
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 an int
by an unsigned conversion. In an unsigned conversion to an int
, the high-order 16 bits of the int
are zero and the low-order 16 bits are equal to the bits of the short
argument. Consequently, zero and positive short
values are mapped to a numerically equal int
value and negative
short
values are mapped to an int
value equal to the input plus 216.
- 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 a long
by an unsigned conversion. In an unsigned conversion to a long
, the high-order 48 bits of the long
are zero and the low-order 16 bits are equal to the bits of the short
argument. Consequently, zero and positive short
values are mapped to a numerically equal long
value and negative
short
values are mapped to a long
value equal to the input plus 216.
- Parameters:
-
x
- the value to convert to an unsignedlong
- Returns:
- the argument converted to
long
by an unsigned conversion - Since:
- 1.8