- java.lang.Object
-
- java.lang.Number
-
- java.lang.Short
-
- All Implemented Interfaces:
- Serializable, Comparable<Short>
public final class Short extends Number implements Comparable<Short>
TheShort
class wraps a value of primitive typeshort
in an object. An object of typeShort
contains a single field whose type isshort
.In addition, this class provides several methods for converting a
short
to aString
and aString
to ashort
, as well as other constants and methods useful when dealing with ashort
.- Since:
- JDK1.1
- See Also:
Number
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description static short
MAX_VALUE
A constant holding the maximum value ashort
can have, 215-1.static short
MIN_VALUE
A constant holding the minimum value ashort
can have, -215.static int
SIZE
The number of bits used to represent ashort
value in two's complement binary form.static Class<Short>
TYPE
TheClass
instance representing the primitive typeshort
.
-
Constructor Summary
Constructors Constructor and Description Short(short value)
Constructs a newly allocatedShort
object that represents the specifiedshort
value.Short(String s)
Constructs a newly allocatedShort
object that represents theshort
value indicated by theString
parameter.
-
Method Summary
Methods Modifier and Type Method and Description byte
byteValue()
Returns the value of thisShort
as abyte
.static int
compare(short x, short y)
Compares twoshort
values numerically.int
compareTo(Short anotherShort)
Compares twoShort
objects numerically.static Short
decode(String nm)
Decodes aString
into aShort
.double
doubleValue()
Returns the value of thisShort
as adouble
.boolean
equals(Object obj)
Compares this object to the specified object.float
floatValue()
Returns the value of thisShort
as afloat
.int
hashCode()
Returns a hash code for thisShort
; equal to the result of invokingintValue()
.int
intValue()
Returns the value of thisShort
as anint
.long
longValue()
Returns the value of thisShort
as along
.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
shortValue()
Returns the value of thisShort
as ashort
.String
toString()
Returns aString
object representing thisShort
's value.static String
toString(short s)
Returns a newString
object representing the specifiedshort
.static Short
valueOf(short s)
Returns aShort
instance representing the specifiedshort
value.static Short
valueOf(String s)
Returns aShort
object holding the value given by the specifiedString
.static Short
valueOf(String s, int radix)
Returns aShort
object holding the value extracted from the specifiedString
when parsed with the radix given by the second argument.
-
-
-
Field Detail
-
MIN_VALUE
public static final short MIN_VALUE
A constant holding the minimum value ashort
can have, -215.- See Also:
- Constant Field Values
-
MAX_VALUE
public static final short MAX_VALUE
A constant holding the maximum value ashort
can have, 215-1.- See Also:
- Constant Field Values
-
TYPE
public static final Class<Short> TYPE
TheClass
instance representing the primitive typeshort
.
-
SIZE
public static final int SIZE
The number of bits used to represent ashort
value in two's complement binary form.- Since:
- 1.5
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Short
public Short(short value)
Constructs a newly allocatedShort
object that represents the specifiedshort
value.- Parameters:
value
- the value to be represented by theShort
.
-
Short
public Short(String s) throws NumberFormatException
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
.- See Also:
parseShort(java.lang.String, int)
-
-
Method Detail
-
toString
public static String toString(short s)
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:
Integer.toString(int)
-
parseShort
public static short parseShort(String s, int radix) throws NumberFormatException
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
public static short parseShort(String s) throws NumberFormatException
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
public static Short valueOf(String s, int radix) throws NumberFormatException
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:new Short(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
public static Short valueOf(String s) throws NumberFormatException
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: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 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
public static Short decode(String nm) throws NumberFormatException
Decodes aString
into aShort
. 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 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:
parseShort(java.lang.String, int)
-
byteValue
public byte byteValue()
Returns the value of thisShort
as abyte
.
-
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
.
-
longValue
public long longValue()
Returns the value of thisShort
as along
.
-
floatValue
public float floatValue()
Returns the value of thisShort
as afloat
.- 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 thisShort
as adouble
.- Specified by:
doubleValue
in classNumber
- Returns:
- the numeric value represented by this object after conversion
to type
double
.
-
toString
public String 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
public int hashCode()
Returns a hash code for thisShort
; equal to the result of invokingintValue()
.- Overrides:
hashCode
in classObject
- Returns:
- a hash code value for this
Short
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
equals
public boolean equals(Object obj)
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.- 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 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
-
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.- Returns:
- the value obtained by reversing (or, equivalently, swapping)
the bytes in the specified
short
value. - Since:
- 1.5
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/lang/short.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.