public
final
class
Short
extends Number
implements
Comparable<Short>
java.lang.Object | ||
↳ | java.lang.Number | |
↳ | java.lang.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
.
See also:
Constants | |
---|---|
int |
BYTES
The number of bytes used to represent a |
short |
MAX_VALUE
A constant holding the maximum value a |
short |
MIN_VALUE
A constant holding the minimum value a |
int |
SIZE
The number of bits used to represent a |
Fields | |
---|---|
public
static
final
Class<Short> |
TYPE
The |
Public constructors | |
---|---|
Short(short value)
Constructs a newly allocated |
|
Short(String s)
Constructs a newly allocated |
Public methods | |
---|---|
byte
|
byteValue()
Returns the value of this |
static
int
|
compare(short x, short y)
Compares two |
int
|
compareTo(Short anotherShort)
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 |
static
int
|
hashCode(short value)
Returns a hash code for a |
int
|
hashCode()
Returns a hash code for this |
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 |
static
String
|
toString(short s)
Returns a new |
String
|
toString()
Returns a |
static
Short
|
valueOf(String s)
Returns a |
static
Short
|
valueOf(short s)
Returns a |
static
Short
|
valueOf(String s, int radix)
Returns a |
Inherited methods | |
---|---|
From
class
java.lang.Number
| |
From
class
java.lang.Object
| |
From
interface
java.lang.Comparable
|
int BYTES
The number of bytes used to represent a short
value in two's
complement binary form.
Constant Value: 2 (0x00000002)
short MAX_VALUE
A constant holding the maximum value a short
can
have, 215-1.
Constant Value: 32767 (0x00007fff)
short MIN_VALUE
A constant holding the minimum value a short
can
have, -215.
Constant Value: -32768 (0xffff8000)
int SIZE
The number of bits used to represent a short
value in two's
complement binary form.
Constant Value: 16 (0x00000010)
Class<Short> TYPE
The Class
instance representing the primitive type
short
.
Short (short value)
Constructs a newly allocated Short
object that
represents the specified short
value.
Parameters | |
---|---|
value |
short :
the value to be represented by the
Short .
|
Short (String s)
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 |
String :
the String to be converted to a
Short |
Throws | |
---|---|
NumberFormatException |
If the String
does not contain a parsable short . |
See also:
byte byteValue ()
Returns the value of this Short
as a
byte
.
Returns | |
---|---|
byte |
the numeric value represented by this object after conversion
to type byte . |
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 |
short :
the first short to compare |
y |
short :
the second short to compare |
Returns | |
---|---|
int |
the value 0 if x == y ;
a value less than 0 if x < y ; and
a value greater than 0 if x > y |
int compareTo (Short anotherShort)
Compares two Short
objects numerically.
Parameters | |
---|---|
anotherShort |
Short :
the Short to be compared. |
Returns | |
---|---|
int |
the value 0 if this Short is
equal to the argument Short ; a value less than
0 if this Short is numerically less
than the argument Short ; and a value greater than
0 if this Short is numerically
greater than the argument Short (signed
comparison). |
Short decode (String nm)
Decodes a String
into a Short
.
Accepts decimal, hexadecimal, and octal numbers given by
the following grammar:
DecimalNumeral, HexDigits, and OctalDigits are as defined in section 3.10.1 of The Java™ Language Specification, except that underscores are not accepted between digits.
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits
- 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 |
String :
the String to decode. |
Returns | |
---|---|
Short |
a Short object holding the short
value represented by nm |
Throws | |
---|---|
NumberFormatException |
if the String does not
contain a parsable short . |
See also:
double doubleValue ()
Returns the value of this Short
as a
double
.
Returns | |
---|---|
double |
the numeric value represented by this object after conversion
to type double .
|
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.
Parameters | |
---|---|
obj |
Object :
the object to compare with |
Returns | |
---|---|
boolean |
true if the objects are the same;
false otherwise.
|
float floatValue ()
Returns the value of this Short
as a
float
.
Returns | |
---|---|
float |
the numeric value represented by this object after conversion
to type float .
|
int hashCode (short value)
Returns a hash code for a short
value; compatible with
Short.hashCode()
.
Parameters | |
---|---|
value |
short :
the value to hash |
Returns | |
---|---|
int |
a hash code value for a short value. |
int hashCode ()
Returns a hash code for this Short
; equal to the result
of invoking intValue()
.
Returns | |
---|---|
int |
a hash code value for this Short
|
int intValue ()
Returns the value of this Short
as an
int
.
Returns | |
---|---|
int |
the numeric value represented by this object after conversion
to type int .
|
long longValue ()
Returns the value of this Short
as a
long
.
Returns | |
---|---|
long |
the numeric value represented by this object after conversion
to type long .
|
short parseShort (String s)
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 |
String :
a String containing the short
representation to be parsed |
Returns | |
---|---|
short |
the short value represented by the
argument in decimal. |
Throws | |
---|---|
NumberFormatException |
If the string does not
contain a parsable short .
|
short parseShort (String s, int radix)
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 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:
null
or is a string of
length zero.
MIN_RADIX
or larger than MAX_RADIX
.
'-'
('\u002D'
) or plus sign
'+'
('\u002B'
) provided that the
string is longer than length 1.
short
.
Parameters | |
---|---|
s |
String :
the String containing the
short representation to be parsed |
radix |
int :
the radix to be used while parsing s |
Returns | |
---|---|
short |
the short represented by the string
argument in the specified radix. |
Throws | |
---|---|
NumberFormatException |
If the String
does not contain a parsable short .
|
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 |
short
|
Returns | |
---|---|
short |
the value obtained by reversing (or, equivalently, swapping)
the bytes in the specified short value. |
short shortValue ()
Returns the value of this Short
as a
short
.
Returns | |
---|---|
short |
the numeric value represented by this object after conversion
to type short . |
String toString (short s)
Returns a new String
object representing the
specified short
. The radix is assumed to be 10.
Parameters | |
---|---|
s |
short :
the short to be converted |
Returns | |
---|---|
String |
the string representation of the specified short |
See also:
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.
Returns | |
---|---|
String |
a string representation of the value of this object in base 10. |
Short valueOf (String s)
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 |
String :
the string to be parsed |
Returns | |
---|---|
Short |
a Short object holding the value
represented by the string argument |
Throws | |
---|---|
NumberFormatException |
If the String does
not contain a parsable short .
|
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 |
short :
a short value. |
Returns | |
---|---|
Short |
a Short instance representing s . |
Short valueOf (String s, int radix)
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 |
String :
the string to be parsed |
radix |
int :
the radix to be used in interpreting s |
Returns | |
---|---|
Short |
a Short object holding the value
represented by the string argument in the
specified radix. |
Throws | |
---|---|
NumberFormatException |
If the String does
not contain a parsable short .
|