Класс Short

java.lang.Object

java.lang.Number

java.lang.Short

Все реализуемые интерфейсы:: Serializable, Comparable<Short>, Constable

public final class Short extends Number implements Comparable<Short>, Constable

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

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

Это класс с базовым значением; программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать экземпляры для синхронизации, иначе может произойти непредсказуемое поведение. Например, в будущей версии синхронизация может завершиться неудачно.

С:

1.1

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`BYTES`	Количество байтов, используемых для представления значения `short` в двоичной форме со знаком.
`static final short`	`MAX_VALUE`	Константа, содержащая максимальное значение, которое может иметь `short`, 2¹⁵-1.
`static final short`	`MIN_VALUE`	Константа, содержащая минимальное значение, которое может иметь `short`, -2¹⁵.
`static final int`	`SIZE`	Количество битов, используемых для представления значения `short` в двоичной форме со знаком.
`static final Class<Short>`	`TYPE`	Экземпляр `Class`, представляющий примитивный тип `short`.

Краткое описание конструкторов

Конструктор	Описание
`Short(short value)`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Использование этого конструктора редко уместно.
`Short(String s)`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Использование этого конструктора редко уместно.

Краткое описание методов

Модификатор и тип	Метод	Описание
`byte`	`byteValue()`	Возвращает значение этого `Short` в качестве `byte` после сужения примитивного преобразования.
`static int`	`compare(short x, short y)`	Сравнивает два значения `short` численно.
`int`	`compareTo(Short anotherShort)`	Сравнивает два объекта `Short` численно.
`static int`	`compareUnsigned(short x, short y)`	Сравнивает два значения `short` численно, рассматривая их как беззнаковые.
`static Short`	`decode(String nm)`	Декодирует `String` в `Short`.
`Optional<DynamicConstantDesc<Short>>`	`describeConstable()`	Возвращает `Optional`, содержащий номинальный дескриптор для данного экземпляра.
`double`	`doubleValue()`	Возвращает значение этого `Short` в качестве `double` после расширяющего примитивного преобразования.
`boolean`	`equals(Object obj)`	Сравнивает этот объект с указанным объектом.
`float`	`floatValue()`	Возвращает значение этого `Short` в качестве `float` после расширяющего примитивного преобразования.
`int`	`hashCode()`	Возвращает хэш-код для этого `Short`; равный результату вызова `intValue()`.
`static int`	`hashCode(short value)`	Возвращает хэш-код для значения `short`; совместимый с `Short.hashCode()`.
`int`	`intValue()`	Возвращает значение этого `Short` в качестве `int` после расширяющего примитивного преобразования.
`long`	`longValue()`	Возвращает значение этого `Short` в качестве `long` после расширяющего примитивного преобразования.
`static short`	`parseShort(String s)`	Парсит строковый аргумент как знаковое десятичное `short`.
`static short`	`parseShort(String s, int radix)`	Парсит строковый аргумент как знаковое `short` в указанном основанием втором аргументе.
`static short`	`reverseBytes(short i)`	Возвращает значение, полученное путем инвертирования порядка байтов в представлении дополнительного кода двух для указанного значения `short`.
`short`	`shortValue()`	Возвращает значение этого `Short` в качестве `short`.
`String`	`toString()`	Возвращает объект `String`, представляющий значение этого `Short`.
`static String`	`toString(short s)`	Возвращает новый объект `String`, представляющий указанное значение `short`.
`static int`	`toUnsignedInt(short x)`	Преобразует аргумент в `int` с помощью беззнакового преобразования.
`static long`	`toUnsignedLong(short x)`	Преобразует аргумент в `long` с помощью беззнакового преобразования.
`static Short`	`valueOf(short s)`	Возвращает экземпляр `Short`, представляющий указанное значение `short`.
`static Short`	`valueOf(String s)`	Возвращает объект `Short`, содержащий значение, заданное указанным `String`.
`static Short`	`valueOf(String s, int radix)`	Возвращает объект `Short`, содержащий значение, извлеченное из указанного `String` при парсинге с основанием, заданным вторым аргументом.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание полей

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

@Deprecated(since="9", forRemoval=true) public Short(short value)

Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Редко уместно использовать этот конструктор. Статический фабричный метод valueOf(short) обычно является лучшим выбором, так как, вероятно, обеспечит значительно лучшую производительность по памяти и времени.

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

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

Short

@Deprecated(since="9", forRemoval=true) public Short(String s) throws NumberFormatException

Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Редко уместно использовать этот конструктор. Используйте parseShort(String) для преобразования строки в примитивное значение short или valueOf(String) для преобразования строки в объект Short.

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

Параметры:: s - строка, которая должна быть преобразована в значение типа Short
Исключения:: NumberFormatException - Если строка не содержит parsable значение типа short.

Подробное описание методов

toString

public static String toString(short s)

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

Параметры:

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

Возвращает:

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

См. также:

parseShort

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

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

Исключение типа NumberFormatException выбрасывается, если выполняется одно из следующих условий:

Первый аргумент является null или представляет собой строку нулевой длины.
Основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
Любой символ в строке не является цифрой в заданном основании, за исключением того, что первый символ может быть знаком минус '-' ('\u002D') или знаком плюс '+' ('\u002B'), при условии, что длина строки больше 1.
Значение, представленное строкой, не является значением типа short.

Parameters:: s - строка, содержащая строковое представление для парсинга; radix - основание, используемое при парсинге s
Returns:: значение short, представленное строковым аргументом в указанном основании.
Throws:: NumberFormatException - Если строка не содержит парсируемого short.

parseShort

public static short parseShort(String s) throws NumberFormatException

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

Parameters:: s - строка, содержащая строковое представление для парсинга
Returns:: значение short, представленное аргументом в десятичной системе.
Throws:: NumberFormatException - Если строка не содержит парсируемого short.

valueOf

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

Возвращает объект Short, содержащий значение, извлечённое из указанной String при парсинге с указанным основанием. Первый аргумент интерпретируется как представление целого числа со знаком short в основании, указанном вторым аргументом, точно так же, как если бы аргумент был передан методу parseShort(java.lang.String, int). Результатом является объект Short, который представляет собой значение short, заданное строкой.

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

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

Parameters:: s - строка для парсинга; radix - основание, используемое при интерпретации s
Returns:: объект Short, содержащий значение, представленное строковым аргументом в заданном основании.
Throws:: NumberFormatException - Если строка не содержит парсируемого short.

valueOf

public static Short valueOf(String s) throws NumberFormatException

Возвращает объект Short, содержащий значение, заданное указанной String. Аргумент интерпретируется как представление целого числа со знаком в десятичной системе счисления, точно так же, как если бы аргумент был передан методу parseShort(java.lang.String). Результатом является объект Short, который представляет собой значение short, заданное строкой.

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

Short.valueOf(Short.parseShort(s))

Parameters:: s - строка для парсинга
Returns:: объект Short, содержащий значение, представленное строковым аргументом
Throws:: NumberFormatException - Если строка не содержит парсируемого short.

describeConstable

public Optional<DynamicConstantDesc<Short>> describeConstable()

Возвращает Optional, содержащий номинальный дескриптор для этого экземпляра.

Указано:: describeConstable в интерфейсе Constable
Возвращает:: a Optional, описывающий экземпляр Short
С:: 15

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

Декодирует строку String в значение типа Short. Принимает десятичные, шестнадцатеричные и восьмеричные числа, задаваемые следующей грамматикой:

ДекодируемаяСтрока:

Знак_доп ДесятичноеЧисло
Знак_доп 0x ШестнадцатеричныеЦифры
Знак_доп 0X ШестнадцатеричныеЦифры
Знак_доп # ШестнадцатеричныеЦифры
Знак_доп 0 ВосьмеричныеЦифры

Знак:

-
+

ДесятичноеЧисло, ШестнадцатеричныеЦифры и ВосьмеричныеЦифры определяются в разделе 3.10.1 спецификации языка Java, за исключением того, что нижние подчёркивания между цифрами не допускаются.

Последовательность символов после необязательного знака и/или спецификатора основания ("0x", "0X", "#" или ведущий ноль) анализируется методом Short.parseShort с указанным основанием (10, 16 или 8). Эта последовательность символов должна представлять положительное значение, в противном случае будет выброшено исключение NumberFormatException. Результат инвертируется, если первый символ указанной String является знаком минус. В строке String не допускаются пробелы.

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

byteValue

public byte byteValue()

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

Переопределяет:: byteValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования в тип byte.
См. Спецификацию языка Java:: 5.1.3 Преобразование сужающего примитивного типа

shortValue

public short shortValue()

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

Переопределяет:: shortValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования в тип short.

intValue

public int intValue()

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

Указано:: intValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования в тип int.
См. Спецификацию языка Java:: 5.1.2 Преобразование расширяющего примитивного типа

longValue

public long longValue()

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

Указано в:: longValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу long.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивов

floatValue

public float floatValue()

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

Указано в:: floatValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу float.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивов

doubleValue

public double doubleValue()

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

Указано в:: doubleValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу double.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивов

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление значения этого объекта в системе счисления с основанием 10.

hashCode

public int hashCode()

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

Переопределяет:

hashCode в классе Object

Возвращает:

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

См. также:

hashCode

public static int hashCode(short value)

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

Параметры:: value - значение, для которого нужно вычислить хэш-код
Возвращает:: значение кода хэша для значения short.
С тех пор как:: 1.8

equals

public boolean equals(Object obj)

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

Переопределяет:

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

compareTo

public int compareTo(Short anotherShort)

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

Specified by:: compareTo в интерфейсе Comparable<Short>
Parameters:: anotherShort - сравниваемый Short.
Returns:: значение 0, если этот Short равен аргументу Short; значение меньше 0, если этот Short численно меньше аргумента Short; и значение больше 0, если этот Short численно больше аргумента Short (сравнение со знаком).
Since:: 1.2

compare

public static int compare(short x, short y)

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

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

Parameters:: x - первое short для сравнения; y - второе short для сравнения
Returns:: значение 0, если x == y; значение меньше 0, если x < y; и значение больше 0, если x > y
Since:: 1.7

compareUnsigned

public static int compareUnsigned(short x, short y)

Сравнивает два значения short численно, рассматривая значения как беззнаковые.

Parameters:: x - первое short для сравнения; y - второе short для сравнения
Returns:: значение 0, если x == y; значение меньше 0, если x < y как беззнаковые значения; и значение больше 0, если x > y как беззнаковые значения
Since:: 9

reverseBytes

public static short reverseBytes(short i)

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

Parameters:: i - значение, байты которого нужно перевернуть
Returns:: значение, полученное путем изменения (или, эквивалентно, перестановки) байтов в указанном значении short.
Since:: 1.5

toUnsignedInt

public static int toUnsignedInt(short x)

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


 short

отображаются на значение int, равное вводу плюс 2¹⁶.

Parameters:: x - значение для преобразования в беззнаковое int
Returns:: аргумент, преобразованный в int посредством беззнакового преобразования
Since:: 1.8

toUnsignedLong

public static long toUnsignedLong(short x)

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


 short

отображаются на значение long, равное вводу плюс 2¹⁶.

Parameters:: x - значение для преобразования в беззнаковое long
Returns:: аргумент, преобразованный в long посредством беззнакового преобразования
Since:: 1.8

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Short.html