- java.lang.Object
- 
- java.lang.Number
- 
- java.lang.Short
 
 
- 
- All Implemented Interfaces:
- Serializable,- Comparable<Short>
 
 public final class Short extends Number implements Comparable<Short> TheShortclass wraps a value of primitive typeshortin an object. An object of typeShortcontains a single field whose type isshort.In addition, this class provides several methods for converting a shortto aStringand aStringto ashort, as well as other constants and methods useful when dealing with ashort.- Since:
- 1.1
- See Also:
- Number, Serialized Form
 
- 
- 
Field SummaryFields Modifier and Type Field Description static intBYTESThe number of bytes used to represent ashortvalue in two's complement binary form.static shortMAX_VALUEA constant holding the maximum value ashortcan have, 215-1.static shortMIN_VALUEA constant holding the minimum value ashortcan have, -215.static intSIZEThe number of bits used to represent ashortvalue in two's complement binary form.static Class<Short>TYPETheClassinstance representing the primitive typeshort.
 - 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description bytebyteValue()Returns the value of thisShortas abyteafter a narrowing primitive conversion.static intcompare(short x, short y)Compares twoshortvalues numerically.intcompareTo(Short anotherShort)Compares twoShortobjects numerically.static intcompareUnsigned(short x, short y)Compares twoshortvalues numerically treating the values as unsigned.static Shortdecode(String nm)Decodes aStringinto aShort.doubledoubleValue()Returns the value of thisShortas adoubleafter a widening primitive conversion.booleanequals(Object obj)Compares this object to the specified object.floatfloatValue()Returns the value of thisShortas afloatafter a widening primitive conversion.inthashCode()Returns a hash code for thisShort; equal to the result of invokingintValue().static inthashCode(short value)Returns a hash code for ashortvalue; compatible withShort.hashCode().intintValue()Returns the value of thisShortas anintafter a widening primitive conversion.longlongValue()Returns the value of thisShortas alongafter a widening primitive conversion.static shortparseShort(String s)Parses the string argument as a signed decimalshort.static shortparseShort(String s, int radix)Parses the string argument as a signedshortin the radix specified by the second argument.static shortreverseBytes(short i)Returns the value obtained by reversing the order of the bytes in the two's complement representation of the specifiedshortvalue.shortshortValue()Returns the value of thisShortas ashort.StringtoString()Returns aStringobject representing thisShort's value.static StringtoString(short s)Returns a newStringobject representing the specifiedshort.static inttoUnsignedInt(short x)Converts the argument to anintby an unsigned conversion.static longtoUnsignedLong(short x)Converts the argument to alongby an unsigned conversion.static ShortvalueOf(short s)Returns aShortinstance representing the specifiedshortvalue.static ShortvalueOf(String s)Returns aShortobject holding the value given by the specifiedString.static ShortvalueOf(String s, int radix)Returns aShortobject holding the value extracted from the specifiedStringwhen parsed with the radix given by the second argument.
 
- 
- 
- 
Field Detail- 
MIN_VALUEpublic static final short MIN_VALUE A constant holding the minimum value ashortcan have, -215.- See Also:
- Constant Field Values
 
 - 
MAX_VALUEpublic static final short MAX_VALUE A constant holding the maximum value ashortcan have, 215-1.- See Also:
- Constant Field Values
 
 - 
TYPEpublic static final Class<Short> TYPE TheClassinstance representing the primitive typeshort.
 - 
SIZEpublic static final int SIZE The number of bits used to represent ashortvalue in two's complement binary form.- Since:
- 1.5
- See Also:
- Constant Field Values
 
 - 
BYTESpublic static final int BYTES The number of bytes used to represent ashortvalue in two's complement binary form.- Since:
- 1.8
- See Also:
- Constant Field Values
 
 
- 
 - 
Constructor Detail- 
Short@Deprecated(since="9") public Short(short value) Deprecated.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 allocatedShortobject that represents the specifiedshortvalue.- Parameters:
- value- the value to be represented by the- Short.
 
 - 
Short@Deprecated(since="9") public Short(String s) throws NumberFormatException Deprecated.It is rarely appropriate to use this constructor. UseparseShort(String)to convert a string to ashortprimitive, or usevalueOf(String)to convert a string to aShortobject.Constructs a newly allocatedShortobject that represents theshortvalue indicated by theStringparameter. The string is converted to ashortvalue in exactly the manner used by theparseShortmethod for radix 10.- Parameters:
- s- the- Stringto be converted to a- Short
- Throws:
- NumberFormatException- If the- Stringdoes not contain a parsable- short.
 
 
- 
 - 
Method Detail- 
toStringpublic static String toString(short s) Returns a newStringobject representing the specifiedshort. The radix is assumed to be 10.- Parameters:
- s- the- shortto be converted
- Returns:
- the string representation of the specified short
- See Also:
- Integer.toString(int)
 
 - 
parseShortpublic static short parseShort(String s, int radix) throws NumberFormatException Parses the string argument as a signedshortin 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 resultingshortvalue is returned.An exception of type NumberFormatExceptionis thrown if any of the following situations occurs:-  The first argument is nullor is a string of length zero.
-  The radix is either smaller than Character.MIN_RADIXor 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- the- Stringcontaining the- shortrepresentation to be parsed
- radix- the radix to be used while parsing- s
- Returns:
- the shortrepresented by the string argument in the specified radix.
- Throws:
- NumberFormatException- If the- Stringdoes not contain a parsable- short.
 
-  The first argument is 
 - 
parseShortpublic 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 resultingshortvalue is returned, exactly as if the argument and the radix 10 were given as arguments to theparseShort(java.lang.String, int)method.- Parameters:
- s- a- Stringcontaining the- shortrepresentation to be parsed
- Returns:
- the shortvalue represented by the argument in decimal.
- Throws:
- NumberFormatException- If the string does not contain a parsable- short.
 
 - 
valueOfpublic static Short valueOf(String s, int radix) throws NumberFormatException Returns aShortobject holding the value extracted from the specifiedStringwhen parsed with the radix given by the second argument. The first argument is interpreted as representing a signedshortin the radix specified by the second argument, exactly as if the argument were given to theparseShort(java.lang.String, int)method. The result is aShortobject that represents theshortvalue specified by the string.In other words, this method returns a Shortobject 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 interpreting- s
- Returns:
- a Shortobject holding the value represented by the string argument in the specified radix.
- Throws:
- NumberFormatException- If the- Stringdoes not contain a parsable- short.
 
 - 
valueOfpublic static Short valueOf(String s) throws NumberFormatException Returns aShortobject 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 aShortobject that represents theshortvalue specified by the string.In other words, this method returns a Shortobject equal to the value of:new Short(Short.parseShort(s))- Parameters:
- s- the string to be parsed
- Returns:
- a Shortobject holding the value represented by the string argument
- Throws:
- NumberFormatException- If the- Stringdoes not contain a parsable- short.
 
 - 
valueOfpublic static Short valueOf(short s) Returns aShortinstance representing the specifiedshortvalue. If a newShortinstance 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 Shortinstance representings.
- Since:
- 1.5
 
 - 
decodepublic static Short decode(String nm) throws NumberFormatException Decodes aStringinto aShort. 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
0xHexDigits
- Signopt
0XHexDigits
- Signopt
#HexDigits
- Signopt
0OctalDigits
- Signopt
- Sign:
- -- +
 The sequence of characters following an optional sign and/or radix specifier (" 0x", "0X", "#", or leading zero) is parsed as by theShort.parseShortmethod with the indicated radix (10, 16, or 8). This sequence of characters must represent a positive value or aNumberFormatExceptionwill be thrown. The result is negated if first character of the specifiedStringis the minus sign. No whitespace characters are permitted in theString.- Parameters:
- nm- the- Stringto decode.
- Returns:
- a Shortobject holding theshortvalue represented bynm
- Throws:
- NumberFormatException- if the- Stringdoes not contain a parsable- short.
- See Also:
- parseShort(java.lang.String, int)
 
 - 
byteValuepublic byte byteValue() Returns the value of thisShortas abyteafter a narrowing primitive conversion.
 - 
shortValuepublic short shortValue() Returns the value of thisShortas ashort.- Overrides:
- shortValuein class- Number
- Returns:
- the numeric value represented by this object after conversion
          to type short.
 
 - 
intValuepublic int intValue() Returns the value of thisShortas anintafter a widening primitive conversion.
 - 
longValuepublic long longValue() Returns the value of thisShortas alongafter a widening primitive conversion.
 - 
floatValuepublic float floatValue() Returns the value of thisShortas afloatafter a widening primitive conversion.- Specified by:
- floatValuein class- Number
- Returns:
- the numeric value represented by this object after conversion
          to type float.
- See The Java™ Language Specification:
- 5.1.2 Widening Primitive Conversions
 
 - 
doubleValuepublic double doubleValue() Returns the value of thisShortas adoubleafter a widening primitive conversion.- Specified by:
- doubleValuein class- Number
- Returns:
- the numeric value represented by this object after conversion
          to type double.
- See The Java™ Language Specification:
- 5.1.2 Widening Primitive Conversions
 
 - 
toStringpublic String toString() Returns aStringobject representing thisShort's value. The value is converted to signed decimal representation and returned as a string, exactly as if theshortvalue were given as an argument to thetoString(short)method.
 - 
hashCodepublic int hashCode() Returns a hash code for thisShort; equal to the result of invokingintValue().- Overrides:
- hashCodein class- Object
- Returns:
- a hash code value for this Short
- See Also:
- Object.equals(java.lang.Object),- System.identityHashCode(java.lang.Object)
 
 - 
hashCodepublic static int hashCode(short value) Returns a hash code for ashortvalue; compatible withShort.hashCode().- Parameters:
- value- the value to hash
- Returns:
- a hash code value for a shortvalue.
- Since:
- 1.8
 
 - 
equalspublic boolean equals(Object obj) Compares this object to the specified object. The result istrueif and only if the argument is notnulland is aShortobject that contains the sameshortvalue as this object.- Overrides:
- equalsin class- Object
- Parameters:
- obj- the object to compare with
- Returns:
- trueif the objects are the same;- falseotherwise.
- See Also:
- Object.hashCode(),- HashMap
 
 - 
compareTopublic int compareTo(Short anotherShort) Compares twoShortobjects numerically.- Specified by:
- compareToin interface- Comparable<Short>
- Parameters:
- anotherShort- the- Shortto be compared.
- Returns:
- the value 0if thisShortis equal to the argumentShort; a value less than0if thisShortis numerically less than the argumentShort; and a value greater than0if thisShortis numerically greater than the argumentShort(signed comparison).
- Since:
- 1.2
 
 - 
comparepublic static int compare(short x, short y)Compares twoshortvalues numerically. The value returned is identical to what would be returned by:Short.valueOf(x).compareTo(Short.valueOf(y))- Parameters:
- x- the first- shortto compare
- y- the second- shortto compare
- Returns:
- the value 0ifx == y; a value less than0ifx < y; and a value greater than0ifx > y
- Since:
- 1.7
 
 - 
compareUnsignedpublic static int compareUnsigned(short x, short y)Compares twoshortvalues numerically treating the values as unsigned.- Parameters:
- x- the first- shortto compare
- y- the second- shortto compare
- Returns:
- the value 0ifx == y; a value less than0ifx < yas unsigned values; and a value greater than0ifx > yas unsigned values
- Since:
- 9
 
 - 
reverseBytespublic static short reverseBytes(short i) Returns the value obtained by reversing the order of the bytes in the two's complement representation of the specifiedshortvalue.- Parameters:
- i- the value whose bytes are to be reversed
- Returns:
- the value obtained by reversing (or, equivalently, swapping)
     the bytes in the specified shortvalue.
- Since:
- 1.5
 
 - 
toUnsignedIntpublic static int toUnsignedInt(short x) Converts the argument to anintby an unsigned conversion. In an unsigned conversion to anint, the high-order 16 bits of theintare zero and the low-order 16 bits are equal to the bits of theshortargument. Consequently, zero and positiveshortvalues are mapped to a numerically equalintvalue and negativeshortvalues are mapped to anintvalue equal to the input plus 216.- Parameters:
- x- the value to convert to an unsigned- int
- Returns:
- the argument converted to intby an unsigned conversion
- Since:
- 1.8
 
 - 
toUnsignedLongpublic static long toUnsignedLong(short x) Converts the argument to alongby an unsigned conversion. In an unsigned conversion to along, the high-order 48 bits of thelongare zero and the low-order 16 bits are equal to the bits of theshortargument. Consequently, zero and positiveshortvalues are mapped to a numerically equallongvalue and negativeshortvalues are mapped to alongvalue equal to the input plus 216.- Parameters:
- x- the value to convert to an unsigned- long
- Returns:
- the argument converted to longby an unsigned conversion
- Since:
- 1.8
 
 
- 
 
-