Field Summary

Constructor Summary

Method Summary

Field Details

• MIN_VALUE

  public static final short MIN_VALUE

  A constant holding the minimum value ashort canhave, -2¹⁵.

  See Also:

  • Constant Field Values

• MAX_VALUE

  public static final short MAX_VALUE

  A constant holding the maximum value ashort canhave, 2¹⁵-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'scomplement binary form.

  Since:

  1.5

  See Also:

  • Constant Field Values

• BYTES

  public static final int BYTES

  The number of bytes used to represent ashort value in two'scomplement binary form.

  Since:

  1.8

  See Also:

  • Constant Field Values

Constructor Details

• 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 islikely to yield significantly better space and time performance.

  Constructs a newly allocatedShort object thatrepresents the specifiedshort value.

  Parameters:

  value - the value to be represented by theShort.

• Short

  @Deprecated(since="9")public Short(String s) throwsNumberFormatException

  Deprecated.

  It is rarely appropriate to use this constructor.UseparseShort(String) to convert a string to ashort primitive, or usevalueOf(String)to convert a string to aShort object.

  Constructs a newly allocatedShort object thatrepresents 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.

Method Details

• toString

  public static String toString(short s)

  Returns a newString object representing thespecifiedshort. The radix is assumed to be 10.

  Parameters:

  s - theshort to be converted

  Returns:

  the string representation of the specifiedshort

  See Also:

  • Integer.toString(int)

• parseShort

  public static short parseShort(String s, int radix) throwsNumberFormatException

  Parses the string argument as a signedshort in theradix specified by the second argument. The characters in thestring must all be digits, of the specified radix (asdetermined by whetherCharacter.digit(char, int) returns a nonnegative value) except that the firstcharacter may be an ASCII minus sign'-'('\u002D') to indicate a negative value or anASCII plus sign'+' ('\u002B') toindicate a positive value. The resultingshort valueis returned.

  An exception of typeNumberFormatException isthrown if any of the following situations occurs:

  • The first argument isnull or is a string oflength zero.
  • The radix is either smaller thanCharacter.MIN_RADIX or larger thanCharacter.MAX_RADIX.
  • Any character of the string is not a digit of thespecified radix, except that the first character may be a minussign'-' ('\u002D') or plus sign'+' ('\u002B') provided that thestring is longer than length 1.
  • The value represented by the string is not a value of typeshort.

  Parameters:

  s - theString containing theshort representation to be parsed

  radix - the radix to be used while parsings

  Returns:

  theshort 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) throwsNumberFormatException

  Parses the string argument as a signed decimalshort. The characters in the string must all be decimaldigits, except that the first character may be an ASCII minussign'-' ('\u002D') to indicate anegative value or an ASCII plus sign'+'('\u002B') to indicate a positive value. Theresultingshort value is returned, exactly as if theargument 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:

  theshort 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) throwsNumberFormatException

  Returns aShort object holding the valueextracted from the specifiedString when parsedwith the radix given by the second argument. The first argumentis interpreted as representing a signedshort inthe radix specified by the second argument, exactly as if theargument were given to theparseShort(java.lang.String, int) method. The result is aShort object thatrepresents theshort value specified by the string.

  In other words, this method returns aShort objectequal to the value of:

  Short.valueOf(Short.parseShort(s, radix))

  Parameters:

  s - the string to be parsed

  radix - the radix to be used in interpretings

  Returns:

  aShort 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) throwsNumberFormatException

  Returns aShort object holding thevalue given by the specifiedString. The argumentis interpreted as representing a signed decimalshort, exactly as if the argument were given totheparseShort(java.lang.String) method. The result isaShort object that represents theshort value specified by the string.

  In other words, this method returns aShort objectequal to the value of:

  Short.valueOf(Short.parseShort(s))

  Parameters:

  s - the string to be parsed

  Returns:

  aShort object holding the value represented by the string argument

  Throws:

  NumberFormatException - If theString does not contain a parsableshort.

• describeConstable

  public Optional<DynamicConstantDesc<Short>> describeConstable()

  Returns anOptional containing the nominal descriptor for thisinstance.

  Specified by:

  describeConstable in interface Constable

  Returns:

  anOptional describing theShort instance

  Since:

  15

• valueOf

  public static Short valueOf(short s)

  Returns aShort instance representing the specifiedshort value.If a newShort instance is not required, this methodshould generally be used in preference to the constructorShort(short), as this method is likely to yieldsignificantly better space and time performance by cachingfrequently 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:

  aShort instance representings.

  Since:

  1.5

• decode

  public static Short decode(String nm) throwsNumberFormatException

  Decodes aString into aShort.Accepts decimal, hexadecimal, and octal numbers given bythe following grammar:

  DecodableString:

  Sign_opt DecimalNumeral

  Sign_opt0xHexDigits

  Sign_opt0XHexDigits

  Sign_opt#HexDigits

  Sign_opt0OctalDigits

  Sign:

  -

  +

  DecimalNumeral,HexDigits, andOctalDigitsare as defined in section3.10.1 ofThe Java Language Specification,except that underscores are not accepted between digits.

  The sequence of characters following an optionalsign and/or radix specifier ("0x", "0X","#", or leading zero) is parsed as by theShort.parseShort method with the indicated radix (10, 16, or8). This sequence of characters must represent a positivevalue or aNumberFormatException will be thrown. Theresult is negated if first character of the specifiedString is the minus sign. No whitespace characters arepermitted in theString.

  Parameters:

  nm - theString to decode.

  Returns:

  aShort 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 aftera narrowing primitive conversion.

  Overrides:

  byteValue in class Number

  Returns:

  the numeric value represented by this object after conversion to typebyte.

  SeeJava Language Specification:

  5.1.3 Narrowing Primitive Conversion
  

• shortValue

  public short shortValue()

  Returns the value of thisShort as ashort.

  Overrides:

  shortValue in class Number

  Returns:

  the numeric value represented by this object after conversion to typeshort.

• intValue

  public int intValue()

  Returns the value of thisShort as anint aftera widening primitive conversion.

  Specified by:

  intValue in class Number

  Returns:

  the numeric value represented by this object after conversion to typeint.

  SeeJava Language Specification:

  5.1.2 Widening Primitive Conversion
  

• longValue

  public long longValue()

  Returns the value of thisShort as along aftera widening primitive conversion.

  Specified by:

  longValue in class Number

  Returns:

  the numeric value represented by this object after conversion to typelong.

  SeeJava Language Specification:

  5.1.2 Widening Primitive Conversion
  

• floatValue

  public float floatValue()

  Returns the value of thisShort as afloatafter a widening primitive conversion.

  Specified by:

  floatValue in class Number

  Returns:

  the numeric value represented by this object after conversion to typefloat.

  SeeJava Language Specification:

  5.1.2 Widening Primitive Conversion
  

• doubleValue

  public double doubleValue()

  Returns the value of thisShort as adoubleafter a widening primitive conversion.

  Specified by:

  doubleValue in class Number

  Returns:

  the numeric value represented by this object after conversion to typedouble.

  SeeJava Language Specification:

  5.1.2 Widening Primitive Conversion
  

• toString

  public String toString()

  Returns aString object representing thisShort's value. The value is converted to signeddecimal representation and returned as a string, exactly as iftheshort value were given as an argument to thetoString(short) method.

  Overrides:

  toString in class Object

  Returns:

  a string representation of the value of this object in base 10.

• hashCode

  public int hashCode()

  Returns a hash code for thisShort; equal to the resultof invokingintValue().

  Overrides:

  hashCode in class Object

  Returns:

  a hash code value for thisShort

  See Also:

  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

• hashCode

  public static int hashCode(short value)

  Returns a hash code for ashort value; compatible withShort.hashCode().

  Parameters:

  value - the value to hash

  Returns:

  a hash code value for ashort value.

  Since:

  1.8

• 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 thatcontains the sameshort value as this object.

  Overrides:

  equals in class Object

  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 interface Comparable<Short>

  Parameters:

  anotherShort - theShort to be compared.

  Returns:

  the value0 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 compare

  y - the secondshort to compare

  Returns:

  the value0 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 twoshort values numerically treating the valuesas unsigned.

  Parameters:

  x - the firstshort to compare

  y - the secondshort to compare

  Returns:

  the value0 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 thetwo's complement representation of the specifiedshort value.

  Parameters:

  i - the value whose bytes are to be reversed

  Returns:

  the value obtained by reversing (or, equivalently, swapping) the bytes in the specifiedshort value.

  Since:

  1.5

• toUnsignedInt

  public static int toUnsignedInt(short x)

  Converts the argument to anint by an unsignedconversion. In an unsigned conversion to anint, thehigh-order 16 bits of theint are zero and thelow-order 16 bits are equal to the bits of theshort argument.Consequently, zero and positiveshort values are mappedto a numerically equalint value and negativeshort values are mapped to anint value equal to theinput plus 2¹⁶.

  Parameters:

  x - the value to convert to an unsignedint

  Returns:

  the argument converted toint by an unsigned conversion

  Since:

  1.8

• toUnsignedLong

  public static long toUnsignedLong(short x)

  Converts the argument to along by an unsignedconversion. In an unsigned conversion to along, thehigh-order 48 bits of thelong are zero and thelow-order 16 bits are equal to the bits of theshort argument.Consequently, zero and positiveshort values are mappedto a numerically equallong value and negativeshort values are mapped to along value equal to theinput plus 2¹⁶.

  Parameters:

  x - the value to convert to an unsignedlong

  Returns:

  the argument converted tolong by an unsigned conversion

  Since:

  1.8