Класс Короткий

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

См. также:

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 генерируется, если возникает любая из следующих ситуаций:

Первый аргумент пустой или имеет нулевую длину.
Основание меньше 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 равный значению:

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

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

valueOf

public static Short valueOf(String s) throws NumberFormatException

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

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

new Short(Short.parseShort(s))

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

Parameters:: s - значение типа short.
Returns:: экземпляр Short , представляющий s.
Since:: 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 - строка String для декодирования.

Returns:

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

Throws:

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

See Also:

parseShort(java.lang.String, int)

byteValue

public byte byteValue()

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

Overrides:: byteValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу byte.
See Java Language Specification:: 5.1.3 Сужение примитивного типа

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 Расширение примитивного типа

longValue

public long longValue()

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

Specified by:: longValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу long.
See Java Language Specification:: 5.1.2 Расширение примитивного типа

floatValue

public float floatValue()

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

Specified by:: floatValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу float.
See Java Language Specification:: 5.1.2 Расширение примитивного типа

doubleValue

public double doubleValue()

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

Specified by:: doubleValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу double.
See Java Language Specification:: 5.1.2 Расширение примитивного типа

toString

public String toString()

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

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

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 численно, рассматривая значения как беззнаковые.

Параметры:: 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, 2021, 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/17/docs/api/java.base/java/lang/Short.html