Short
  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:
Summary
| Constants | |
|---|---|
| int | BYTESThe number of bytes used to represent a  | 
| short | MAX_VALUEA constant holding the maximum value a  | 
| short | MIN_VALUEA constant holding the minimum value a  | 
| int | SIZEThe number of bits used to represent a  | 
| Fields | |
|---|---|
| 
    public
    static
    final
    Class<Short> | TYPEThe  | 
| Public constructors | |
|---|---|
| 
      Short(String s)
      
      This constructor is deprecated.
    It is rarely appropriate to use this constructor.
 Use  | |
| 
      Short(short value)
      
      This constructor is deprecated.
    It is rarely appropriate to use this constructor. The static factory
  | |
| 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
        
        
        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  | 
| 
        
        
        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
        
        
        int | 
      toUnsignedInt(short x)
      Converts the argument to an  | 
| 
        
        
        static
        
        
        long | 
      toUnsignedLong(short x)
      Converts the argument to 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 | |
|---|---|
Constants
BYTES
public static final int BYTES
The number of bytes used to represent a short value in two's
 complement binary form.
Constant Value: 2 (0x00000002)
MAX_VALUE
public static final short MAX_VALUE
A constant holding the maximum value a short can
 have, 215-1.
Constant Value: 32767 (0x00007fff)
MIN_VALUE
public static final short MIN_VALUE
A constant holding the minimum value a short can
 have, -215.
Constant Value: -32768 (0xffff8000)
SIZE
public static final int SIZE
The number of bits used to represent a short value in two's
 complement binary form.
Constant Value: 16 (0x00000010)
Fields
TYPE
public static final Class<Short> TYPE
The Class instance representing the primitive type
 short.
Public constructors
Short
public Short (String s)
      This constructor is deprecated.
    It is rarely appropriate to use this constructor.
 Use parseShort(java.lang.String) to convert a string to a
 short primitive, or use valueOf(java.lang.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 | String: theStringto be converted to aShort | 
| Throws | |
|---|---|
| NumberFormatException | If the Stringdoes not contain a parsableshort. | 
Short
public Short (short value)
      This constructor is deprecated.
    It is rarely appropriate to use this constructor. The static factory
 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 | short: the value to be represented by theShort. | 
Public methods
byteValue
public byte byteValue ()
Returns the value of this Short as a byte after
 a narrowing primitive conversion.
| Returns | |
|---|---|
| byte | the numeric value represented by this object after conversion
          to type byte. | 
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 | short: the firstshortto compare | 
| y | short: the secondshortto compare | 
| Returns | |
|---|---|
| int | the value 0ifx == y;
         a value less than0ifx < y; and
         a value greater than0ifx > y | 
compareTo
public int compareTo (Short anotherShort)
Compares two Short objects numerically.
| Parameters | |
|---|---|
| anotherShort | Short: theShortto be compared. | 
| Returns | |
|---|---|
| int | 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). | 
compareUnsigned
public static int compareUnsigned (short x, 
                short y)Compares two short values numerically treating the values
 as unsigned.
| Parameters | |
|---|---|
| x | short: the firstshortto compare | 
| y | short: the secondshortto compare | 
| Returns | |
|---|---|
| int | the value 0ifx == y; a value less
         than0ifx < yas unsigned values; and
         a value greater than0ifx > yas
         unsigned values | 
decode
public static 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 {@jls 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- 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: theStringto decode. | 
| Returns | |
|---|---|
| Short | a Shortobject holding theshortvalue represented bynm | 
| Throws | |
|---|---|
| NumberFormatException | if the Stringdoes not
            contain a parsableshort. | 
See also:
doubleValue
public double doubleValue ()
Returns the value of this Short as a double
 after a widening primitive conversion.
| Returns | |
|---|---|
| double | the numeric value represented by this object after conversion
          to type double. | 
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.
| Parameters | |
|---|---|
| obj | Object: the object to compare with | 
| Returns | |
|---|---|
| boolean | trueif the objects are the same;falseotherwise. | 
floatValue
public float floatValue ()
Returns the value of this Short as a float
 after a widening primitive conversion.
| Returns | |
|---|---|
| float | the numeric value represented by this object after conversion
          to type float. | 
hashCode
public static 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 shortvalue. | 
hashCode
public 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 | 
intValue
public int intValue ()
Returns the value of this Short as an int after
 a widening primitive conversion.
| Returns | |
|---|---|
| int | 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.
| Returns | |
|---|---|
| long | the numeric value represented by this object after conversion
          to type long. | 
parseShort
public static 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: aStringcontaining theshortrepresentation to be parsed | 
| Returns | |
|---|---|
| short | the shortvalue represented by the
          argument in decimal. | 
| Throws | |
|---|---|
| NumberFormatException | If the string does not
          contain a parsable short. | 
parseShort
public static 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 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 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 | String: theStringcontaining theshortrepresentation to be parsed | 
| radix | int: the radix to be used while parsings | 
| Returns | |
|---|---|
| short | the shortrepresented by the string
                  argument in the specified radix. | 
| Throws | |
|---|---|
| NumberFormatException | If the Stringdoes not contain a parsableshort. | 
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 | short: the value whose bytes are to be reversed | 
| Returns | |
|---|---|
| short | the value obtained by reversing (or, equivalently, swapping)
     the bytes in the specified shortvalue. | 
shortValue
public 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. | 
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 | short: theshortto be converted | 
| Returns | |
|---|---|
| String | the string representation of the specified short | 
See also:
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.
| Returns | |
|---|---|
| String | a string representation of the value of this object in base 10. | 
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 | short: the value to convert to an unsignedint | 
| Returns | |
|---|---|
| int | the argument converted to intby an unsigned
         conversion | 
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 | short: the value to convert to an unsignedlong | 
| Returns | |
|---|---|
| long | the argument converted to longby an unsigned
         conversion | 
valueOf
public static 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 Shortobject holding the value
          represented by the string argument | 
| Throws | |
|---|---|
| NumberFormatException | If the Stringdoes
          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 | short: a short value. | 
| Returns | |
|---|---|
| Short | a Shortinstance representings. | 
valueOf
public static 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 interpretings | 
| Returns | |
|---|---|
| Short | a Shortobject holding the value
                  represented by the string argument in the
                  specified radix. | 
| Throws | |
|---|---|
| NumberFormatException | If the Stringdoes
                  not contain a parsableshort. | 
