Класс 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)`	Устарел. Использование этого конструктора редко бывает оправданным.
`Short(String s)`	Устарел. Использование этого конструктора редко бывает оправданным.

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

Модификатор и тип	Метод	Описание
`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` при разборе в системе счисления, заданной вторым аргументом.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарел, будет удален: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в будущей версии.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

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") public Short(short value)

Устарел.

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

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

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

Short

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

Устарел.

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

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

Параметры:: s — значение String, которое требуется преобразовать в Short
Исключения:: NumberFormatException — если значение String не содержит допустимого для разбора значения 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.

Параметры:: s — String, содержащая представление short для разбора; radix — основание системы счисления, используемое при разборе s
Возвращает:: значение short, представленное строковым аргументом в указанной системе счисления.
Исключения:: NumberFormatException — если значение String не содержит допустимого для разбора значения short.

parseShort

public static short parseShort(String s) throws NumberFormatException

Разбирает строковый аргумент как знаковое десятичное значение


short

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

Параметры:: s — String, содержащая представление short для разбора
Возвращает:: значение short, представленное аргументом в десятичной системе счисления.
Исключения:: 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))

Параметры:: s — строка для разбора; radix — основание системы счисления, используемое для интерпретации s
Возвращает:: объект Short, содержащий значение, представленное строковым аргументом в указанной системе счисления.
Исключения:: NumberFormatException — если значение String не содержит допустимого для разбора значения short.

valueOf

public static Short valueOf(String s) throws NumberFormatException

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

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

Short.valueOf(Short.parseShort(s))

Параметры:: s — строка для разбора
Возвращает:: объект Short, содержащий значение, представленное строковым аргументом
Исключения:: NumberFormatException — если значение String не содержит допустимого для разбора значения short.

describeConstable

public Optional<DynamicConstantDesc<Short>> describeConstable()

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

Указан в:: describeConstable в интерфейсе Constable
Возвращает:: 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.

Указан в:: 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

compareUnsigned

public static int compareUnsigned(short x, short y)

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

Параметры:: x — первое значение short для сравнения; y — второе значение short для сравнения
Возвращает:: значение 0, если x == y; значение меньше 0, если x < y рассматриваются как беззнаковые значения; и значение больше 0, если x > y рассматриваются как беззнаковые значения
Начиная с версии:: 9

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

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