Spec-Zone.ru › OpenJDK 25

Класс 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
См. также:
  • Number
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int BYTES
Количество байтов, используемых для представления значения short в двоичной форме с дополнением до двух.
static final short MAX_VALUE
Константа, содержащая максимальное значение, которое может иметь short: 215-1.
static final short MIN_VALUE
Константа, содержащая минимальное значение, которое может иметь short: -215.
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

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

MIN_VALUE

public static final short MIN_VALUE
Константа, содержащая минимальное значение, которое может иметь short: -215.
См. также:
  • Значения констант полей

MAX_VALUE

public static final short MAX_VALUE
Константа, содержащая максимальное значение, которое может иметь short: 215-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
См. также:
  • Integer.toString(int)

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 возвращается точно так же, как если бы строковый аргумент и основание 10 были переданы методу parseShort(java.lang.String, int).
Параметры:
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. Поддерживаются десятичные, шестнадцатеричные и восьмеричные числа, соответствующие следующей грамматике:
DecodableString:
Signopt DecimalNumeral
Signopt 0x HexDigits
Signopt 0X HexDigits
Signopt # HexDigits
Signopt 0 OctalDigits
Sign:
-
+
DecimalNumeral, HexDigits и OctalDigits определены в разделе 3.10.1 документа Спецификация языка Java, за исключением того, что подчеркивания между цифрами не допускаются.

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

Параметры:
nm — String для декодирования.
Возвращает:
объект Short, содержащий значение short, представленное nm
Исключения:
NumberFormatException — если String не содержит разбираемое значение short.
См. также:
  • parseShort(java.lang.String, int)

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
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(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, что и этот объект.
Переопределяет:
equals в классе Object
Параметры:
obj — объект для сравнения
Возвращает:
true, если объекты совпадают; в противном случае — false.
См. также:
  • Object.hashCode()
  • HashMap

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, равное входному значению плюс 216.
Параметры:
x — значение для преобразования в беззнаковое int
Возвращает:
аргумент, преобразованный в int путем беззнакового преобразования
Начиная с:
1.8

toUnsignedLong

public static long toUnsignedLong(short x)
Преобразует аргумент в long путем беззнакового преобразования. При беззнаковом преобразовании в long старшие 48 бит значения long равны нулю, а младшие 16 бит совпадают с битами аргумента short. Следовательно, нулевые и положительные значения short преобразуются в численно равное значение long, а отрицательные значения short — в значение long, равное входному значению плюс 216.
Параметры:
x — значение для преобразования в беззнаковое long
Возвращает:
аргумент, преобразованный в long путем беззнакового преобразования
Начиная с:
1.8

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Short.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API