Returns a new String object representing the specified short. The radix is assumed to be 10.

Parameters:

s - the short to be converted

Returns:

the string representation of the specified short

See Also:

• Integer.toString(int)

Parses the string argument as a signed

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

returns a nonnegative value) except that the first character may be an ASCII minus sign

(

) to indicate a negative value or an ASCII plus sign

(

) to indicate a positive value. The resulting

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 than Character.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 String containing the short representation to be parsed

radix - the radix to be used while parsing s

Returns:

the short represented by the string argument in the specified radix.

Throws:

NumberFormatException - If the String does not contain a parsable short.

Parses the string argument as a signed decimal

. The characters in the string must all be decimal digits, except that the first character may be an ASCII minus sign

(

) to indicate a negative value or an ASCII plus sign

(

) to indicate a positive value. The resulting

value is returned, exactly as if the argument and the radix 10 were given as arguments to the

method.

Parameters:

s - a String containing the short representation to be parsed

Returns:

the short value represented by the argument in decimal.

Throws:

NumberFormatException - If the string does not contain a parsable short.

Returns a

object holding the value extracted from the specified

when parsed with the radix given by the second argument. The first argument is interpreted as representing a signed

in the radix specified by the second argument, exactly as if the argument were given to the

method. The result is a

object that represents the

value specified by the string.

In other words, this method returns a Short object equal to the value of:

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

Parameters:

s - the string to be parsed

radix - the radix to be used in interpreting s

Returns:

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.

Returns a

object holding the value given by the specified

. The argument is interpreted as representing a signed decimal

, exactly as if the argument were given to the

method. The result is a

object that represents the

value specified by the string.

In other words, this method returns a Short object equal to the value of:

Short.valueOf(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 the String does not contain a parsable short.

Returns an

containing the nominal descriptor for this instance.

Specified by:

describeConstable in interface Constable

Returns:

an Optional describing the Short instance

Since:

15

Returns a

instance representing the specified

value. If a new

instance is not required, this method should generally be used in preference to the constructor

, 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 representing s.

Since:

1.5

Decodes a

into a

. Accepts decimal, hexadecimal, and octal numbers given by the following grammar:

DecodableString:

Sign_opt DecimalNumeral

Sign_opt 0x HexDigits

Sign_opt 0X HexDigits

Sign_opt # HexDigits

Sign_opt 0 OctalDigits

Sign:

-

+

,

, and

are as defined in section

of

, except that underscores are not accepted between digits.

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 - the String to decode.

Returns:

a Short object holding the short value represented by nm

Throws:

NumberFormatException - if the String does not contain a parsable short.

See Also:

• parseShort(java.lang.String, int)

public byte byteValue()

Returns the value of this Short as a byte after a narrowing primitive conversion.

Overrides:

byteValue in class Number

Returns:

the numeric value represented by this object after conversion to type byte.

See Java Language Specification:

5.1.3 Narrowing Primitive Conversion

public short shortValue()

Returns the value of this Short as a short.

Overrides:

shortValue in class Number

Returns:

the numeric value represented by this object after conversion to type short.

public int intValue()

Returns the value of this Short as an int after a widening primitive conversion.

Specified by:

intValue in class Number

Returns:

the numeric value represented by this object after conversion to type int.

See Java Language Specification:

5.1.2 Widening Primitive Conversion

public long longValue()

Returns the value of this Short as a long after a widening primitive conversion.

Specified by:

longValue in class Number

Returns:

the numeric value represented by this object after conversion to type long.

See Java Language Specification:

5.1.2 Widening Primitive Conversion

public float floatValue()

Returns the value of this Short as a float after a widening primitive conversion.

Specified by:

floatValue in class Number

Returns:

the numeric value represented by this object after conversion to type float.

See Java Language Specification:

5.1.2 Widening Primitive Conversion

public double doubleValue()

Returns the value of this Short as a double after a widening primitive conversion.

Specified by:

doubleValue in class Number

Returns:

the numeric value represented by this object after conversion to type double.

See Java Language Specification:

5.1.2 Widening Primitive Conversion

Returns a

object representing this

's value. The value is converted to signed decimal representation and returned as a string, exactly as if the

value were given as an argument to the

method.

Overrides:

toString in class Object

Returns:

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

public int hashCode()

Returns a hash code for this Short; equal to the result of invoking intValue().

Overrides:

hashCode in class Object

Returns:

a hash code value for this Short

See Also:

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

public static int hashCode(short value)

Returns a hash code for a short value; compatible with Short.hashCode().

Parameters:

value - the value to hash

Returns:

a hash code value for a short value.

Since:

1.8

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.

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

Compares two Short objects numerically.

Specified by:

compareTo in interface Comparable<Short>

Parameters:

anotherShort - the Short to be compared.

Returns:

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).

Since:

1.2

public static int compare(short x, short y)

Compares two

values numerically. The value returned is identical to what would be returned by:

    Short.valueOf(x).compareTo(Short.valueOf(y))
 

Parameters:

x - the first short to compare

y - the second short to compare

Returns:

the value 0 if x == y; a value less than 0 if x < y; and a value greater than 0 if x > y

Since:

1.7

public static int compareUnsigned(short x, short y)

Compares two short values numerically treating the values as unsigned.

Parameters:

x - the first short to compare

y - the second short to compare

Returns:

the value 0 if x == y; a value less than 0 if x < y as unsigned values; and a value greater than 0 if x > y as unsigned values

Since:

9

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 - the value whose bytes are to be reversed

Returns:

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

Since:

1.5

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 2¹⁶.

Parameters:

x - the value to convert to an unsigned int

Returns:

the argument converted to int by an unsigned conversion

Since:

1.8

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 2¹⁶.

Parameters:

x - the value to convert to an unsigned long

Returns:

the argument converted to long by an unsigned conversion

Since:

1.8