Класс Short

Класс Short оборачивает значение примитивного типа short в объект. Объект типа Short содержит единственное поле типа short.

Кроме того, этот класс предоставляет несколько методов для преобразования short в String и String в short, а также другие константы и методы, полезные при работе с short.

Поля

MIN_VALUE

public static final short MIN_VALUE

Константа, хранящая минимальное значение, которое может принимать short, -2¹⁵.

См. также:

Значения константных полей

MAX_VALUE

public static final short MAX_VALUE

Константа, хранящая максимальное значение, которое может принимать short, 2¹⁵-1.

См. также:

Значения константных полей

TYPE

public static final Class<Short> TYPE

Экземпляр Class, представляющий примитивный тип short.

SIZE

public static final int SIZE

Количество бит, используемых для представления значения short в двоичной форме со знаком.

С:

1.5

См. также:

Значения константных полей

BYTES

public static final int BYTES

Количество байт, используемых для представления значения short в двоичной форме со знаком.

С:

1.8

См. также:

Значения константных полей

Конструкторы

Short

public Short(short value)

Создаёт новый объект Short , представляющий указанное значение short.

Параметры:

value - значение, которое должен представлять объект Short.

Short

public Short(String s)
      throws NumberFormatException

Создаёт новый объект Short , представляющий значение short, указанное параметром String . Строка преобразуется в значение short точно так же, как это делает метод parseShort для основания 10.

Параметры:

s - строка, которая должна быть преобразована в значение Short

Исключения:

NumberFormatException - Если строка не содержит анализируемого значения short.

См. также:

parseShort(java.lang.String, int)

Методы

toString

public static String toString(short s)

Возвращает новый объект String , представляющий указанное значение short . Основание считается равным 10.

Параметры:

s - значение short , которое должно быть преобразовано

Возвращает:

строковое представление указанного значения short

См. также:

Integer.toString(int)

parseShort

public static short parseShort(String s,
                               int radix)
                        throws NumberFormatException

Параметры:

s - строка, содержащая строковое представление short для разбора

radix - основание, которое используется при разборе s

Возвращает:

значение short , представленное строковым аргументом в указанном основании.

Исключения:

NumberFormatException - Если строка не содержит анализируемого значения short.

parseShort

public static short parseShort(String s)
                        throws NumberFormatException

Разбирает строковый аргумент как знаковое десятичное значение short . Символы в строке должны быть десятичными цифрами, за исключением того, что первый символ может быть ASCII-знаком минус '-' ('\u002D') для обозначения отрицательного значения или ASCII-знаком плюс '+' ('\u002B') для обозначения положительного значения. Возвращается полученное значение short , точно так же, как если бы аргумент и основание 10 были переданы в метод parseShort(java.lang.String, int).

Параметры:

s - строка, содержащая строковое представление short для разбора

Возвращает:

значение short , представленное аргументом в десятичной системе счисления.

Исключения:

NumberFormatException - Если строка не содержит анализируемого значения short.

valueOf

public static Short valueOf(String s,
                            int radix)
                     throws NumberFormatException

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

Параметры:

s - строка для разбора

radix - основание, используемое для интерпретации s

Возвращает:

объект Short , содержащий значение, представленное строковым аргументом в указанном основании.

Исключения:

NumberFormatException - Если строка не содержит анализируемого значения short.

valueOf

public static Short valueOf(String s)
                     throws NumberFormatException

new Short(Short.parseShort(s))

Параметры:

s - строка для разбора

Возвращает:

объект Short , содержащий значение, представленное строковым аргументом

Исключения:

NumberFormatException - Если строка не содержит анализируемого значения short.

valueOf

public static Short valueOf(short s)

Возвращает экземпляр Short , представляющий указанное значение short . Если экземпляр Short не требуется, этот метод следует использовать вместо конструктора Short(short), так как этот метод, скорее всего, обеспечит значительно лучшую производительность по памяти и времени за счёт кэширования часто запрашиваемых значений. Этот метод всегда будет кэшировать значения в диапазоне от -128 до 127 включительно и может кэшировать другие значения за пределами этого диапазона.

Параметры:

s - значение типа short.

Возвращает:

экземпляр Short , представляющий s.

С:

1.5

decode

public static Short decode(String nm)
                    throws NumberFormatException

Параметры:

nm - строка для декодирования.

Возвращает:

объект Short , содержащий значение short , представленное строкой nm

Исключения:

NumberFormatException - если строка не содержит анализируемого значения short.

См. также:

parseShort(java.lang.String, int)

byteValue

public byte byteValue()

Возвращает значение этого объекта Short как значение типа byte после сужения примитивного преобразования.

Overrides:

byteValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу byte.

shortValue

public short shortValue()

Возвращает значение этого Short в виде short.

Overrides:

shortValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу short.

intValue

public int intValue()

Возвращает значение этого Short в виде int после расширяющего преобразования примитивных типов.

Specified by:

intValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу int.

longValue

public long longValue()

Возвращает значение этого Short в виде long после расширяющего преобразования примитивных типов.

Specified by:

longValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу long.

floatValue

public float floatValue()

Возвращает значение этого Short в виде float после расширяющего преобразования примитивных типов.

Specified by:

floatValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу float.

doubleValue

public double doubleValue()

Возвращает значение этого Short в виде double после расширяющего преобразования примитивных типов.

Specified by:

doubleValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу double.

toString

public String toString()

Возвращает объект String, представляющий значение этого Short. Значение преобразуется в знаковое десятичное представление и возвращается в виде строки, точно так же, как если бы значение short было передано в метод toString(short).

Overrides:

toString в классе Object

Возвращает:

строковое представление значения этого объекта в системе счисления с основанием 10.

hashCode

public int hashCode()

Возвращает хэш-код для этого Short; равный результату вызова intValue().

Overrides:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого Short

См. также:

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

hashCode

public static int hashCode(short value)

Возвращает хэш-код для значения short; совместим с Short.hashCode().

Параметры:

value - значение для хеширования

Возвращает:

значение хэш-кода для значения short.

С момента:

1.8

equals

public boolean equals(Object obj)

Сравнивает этот объект с указанным объектом. Результат — true тогда и только тогда, когда аргумент не null и является объектом типа Short, содержащим то же самое значение short что и этот объект.

Overrides:

equals в классе Object

Параметры:

obj - объект для сравнения

Возвращает:

true если объекты идентичны; false в противном случае.

См. также:

Object.hashCode(), HashMap

compareTo

public int compareTo(Short anotherShort)

Сравнивает два объекта Short численно.

Specified by:

compareTo в интерфейсе Comparable<Short>

Параметры:

anotherShort - сравниваемый Short.

Возвращает:

значение 0 если этот Short равен аргументу Short; значение меньше 0 если этот Short численно меньше аргумента Short; и значение больше 0 если этот Short численно больше аргумента Short (сравнение со знаком).

С момента:

1.2

compare

public static int compare(short x,
                          short y)

Сравнивает два значения short численно. Возвращаемое значение идентично тому, что вернулось бы:

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

Параметры:

x - первое сравниваемое значение short

y - второе сравниваемое значение short

Возвращает:

значение 0 если x == y; значение меньше 0 если x < y; и значение больше 0 если x > y

С момента:

1.7

reverseBytes

public static short reverseBytes(short i)

Возвращает значение, полученное путем перестановки байтов в представлении со знаком минус указанного значения short.

Параметры:

i - значение, байты которого должны быть переставлены

Возвращает:

значение, полученное путем перестановки (или, эквивалентно, перестановки) байтов в указанном значении short.

С момента:

1.5

toUnsignedInt

public static int toUnsignedInt(short x)

Преобразует аргумент в int с помощью беззнакового преобразования. При беззнаковом преобразовании в int, старшие 16 бит int равны нулю, а младшие 16 бит — равны битам аргумента short. Следовательно, нулевые и положительные значения short отображаются на численно равное значение int, а отрицательные значения short отображаются на значение int, равное входу плюс 2¹⁶.

Параметры:

x - значение для преобразования в беззнаковый int

Возвращает:

аргумент, преобразованный в int с помощью беззнакового преобразования

С момента:

1.8

toUnsignedLong

public static long toUnsignedLong(short x)

Преобразует аргумент в long с помощью беззнакового преобразования. При беззнаковом преобразовании в long, старшие 48 бит long равны нулю, а младшие 16 бит — равны битам аргумента short . Следовательно, нулевые и положительные значения short отображаются на численно равное значение long, а отрицательные значения short отображаются на значение long, равное входу плюс 2¹⁶.

Параметры:

x - значение для преобразования в беззнаковый long

Возвращает:

аргумент, преобразованный в long с помощью беззнакового преобразования

С момента:

1.8