Класс Short

Все реализованные интерфейсы:
Serializable, Comparable<Short> 
public final class Short
extends Number
implements Comparable<Short>

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

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

С тех пор:
1.1
См. также:
Number, Сериализованная форма

Поля

Модификатор и тип Поле Описание
static int BYTES

Количество байтов, используемых для представления значения short в двоичной форме со знаком.
static short MAX_VALUE

Константа, содержащая максимальное значение, которое может иметь short, 215-1.
static short MIN_VALUE

Константа, содержащая минимальное значение, которое может иметь short, -215.
static int SIZE

Количество битов, используемых для представления значения short в двоичной форме со знаком.
static 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.
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 (—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 - строка, которая преобразуется в 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 - строка, содержащая строковое представление для парсинга
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 значения, представленного аргументом в десятичной системе.
Использует:
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.

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.
См. также:
parseShort(java.lang.String, int)

byteValue

public byte byteValue()

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

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

shortValue

public short shortValue()

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

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

intValue

public int intValue()

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

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

longValue

public long longValue()

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

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

floatValue

public float floatValue()

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

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

doubleValue

public double doubleValue()

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

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

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(java.lang.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

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

Spec-Zone .ru
спецификации, руководства, описания, API