Класс 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 - если строка не содержит парсируемое значение 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 - строка, содержащая строковое представление 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

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

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

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

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

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

byteValue

public byte byteValue()

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

Overrides:: byteValue в классе Number
Returns:: численный результат, представленный этим объектом после преобразования в тип byte.
See Java Language Specification:: 5.1.3 Narrowing Primitive Conversion

shortValue

public short shortValue()

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

Overrides:: shortValue в классе Number
Returns:: численный результат, представленный этим объектом после преобразования в тип short.

intValue

public int intValue()

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

Specified by:: intValue в классе Number
Returns:: численный результат, представленный этим объектом после преобразования в тип int.
See Java Language Specification:: 5.1.2 Widening Primitive Conversion

longValue

public long longValue()

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

Specified by:: longValue в классе Number
Returns:: численный результат, представленный этим объектом после преобразования в тип long.
See Java Language Specification:: 5.1.2 Widening Primitive Conversion

floatValue

public float floatValue()

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

Specified by:: floatValue в классе Number
Returns:: численный результат, представленный этим объектом после преобразования в тип float.
See Java Language Specification:: 5.1.2 Widening Primitive Conversion

doubleValue

public double doubleValue()

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

Specified by:: doubleValue в классе Number
Returns:: численный результат, представленный этим объектом после преобразования в тип double.
See Java Language Specification:: 5.1.2 Widening Primitive Conversion

toString

public String toString()

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

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

hashCode

public int hashCode()

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

Overrides:

hashCode в классе Object

Returns:

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

See Also:

hashCode

public static int hashCode(short value)

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

Parameters:: value - значение для хеширования
Returns:: значение хэш-кода для значения типа short.
Since:: 1.8

equals

public boolean equals(Object obj)

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

Overrides:

equals в классе Object

Parameters:

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

Returns:

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

See Also:

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

Преобразовать в беззнаковый int

public static int toUnsignedInt(short x)

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


 short

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

Параметры:: x - значение для преобразования в беззнаковый int
Возвращает:: аргумент, преобразованный в int с помощью беззнакового преобразования
С:: 1.8

Преобразовать в беззнаковый long

public static long toUnsignedLong(short x)

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


 short

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

Параметры:: x - значение для преобразования в беззнаковый long
Возвращает:: аргумент, преобразованный в long с помощью беззнакового преобразования
С:: 1.8

© 1993, 2023, 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/21/docs/api/java.base/java/lang/Short.html