Класс Byte

java.lang.Object

java.lang.Number

java.lang.Byte

Все реализованные интерфейсы:: Serializable, Comparable<Byte>, Constable

public final class Byte extends Number implements Comparable<Byte>, Constable

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

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

Это класс значение-объект; программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать экземпляры для синхронизации, иначе может произойти непредсказуемое поведение. Например, в будущей версии синхронизация может не сработать.

С:

1.1

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`BYTES`	Количество байтов, используемых для представления значения `byte` в двоичной форме со знаком.
`static final byte`	`MAX_VALUE`	Константа, хранящая максимальное значение, которое может иметь `byte`, 2⁷-1.
`static final byte`	`MIN_VALUE`	Константа, хранящая минимальное значение, которое может иметь `byte`, -2⁷.
`static final int`	`SIZE`	Количество битов, используемых для представления значения `byte` в двоичной форме со знаком.
`static final Class<Byte>`	`TYPE`	Экземпляр `Class` представляющий примитивный тип `byte`.

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

Конструктор	Описание
`Byte(byte value)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Использование этого конструктора редко уместно.
`Byte(String s)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Использование этого конструктора редко уместно.

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

Модификатор и тип	Метод	Описание
`byte`	`byteValue()`	Возвращает значение этого `Byte` в виде `byte`.
`static int`	`compare(byte x, byte y)`	Сравнивает два значения `byte` численно.
`int`	`compareTo(Byte anotherByte)`	Сравнивает два объекта `Byte` численно.
`static int`	`compareUnsigned(byte x, byte y)`	Сравнивает два значения `byte` численно, рассматривая значения как беззнаковые.
`static Byte`	`decode(String nm)`	Декодирует `String` в `Byte`.
`Optional<DynamicConstantDesc<Byte>>`	`describeConstable()`	Возвращает `Optional`, содержащий номинальный дескриптор для этого экземпляра.
`double`	`doubleValue()`	Возвращает значение этого `Byte` как `double` после расширяющего преобразования примитивного типа.
`boolean`	`equals(Object obj)`	Сравнивает этот объект с указанным объектом.
`float`	`floatValue()`	Возвращает значение этого `Byte` как `float` после расширяющего преобразования примитивного типа.
`int`	`hashCode()`	Возвращает хэш-код для этого `Byte`; равный результату вызова `intValue()`.
`static int`	`hashCode(byte value)`	Возвращает хэш-код для значения `byte` ; совместим с `Byte.hashCode()`.
`int`	`intValue()`	Возвращает значение этого `Byte` как `int` после расширяющего преобразования примитивного типа.
`long`	`longValue()`	Возвращает значение этого `Byte` как `long` после расширяющего преобразования примитивного типа.
`static byte`	`parseByte(String s)`	Парсит строковый аргумент как целое десятичное значение `byte`.
`static byte`	`parseByte(String s, int radix)`	Парсит строковый аргумент как целое `byte` в указанной системе счисления.
`short`	`shortValue()`	Возвращает значение этого `Byte` как `short` после расширяющего преобразования примитивного типа.
`String`	`toString()`	Возвращает объект `String`, представляющий значение этого `Byte`.
`static String`	`toString(byte b)`	Возвращает новый объект `String`, представляющий указанное значение `byte`.
`static int`	`toUnsignedInt(byte x)`	Преобразует аргумент в `int` с помощью беззнакового преобразования.
`static long`	`toUnsignedLong(byte x)`	Преобразует аргумент в `long` с помощью беззнакового преобразования.
`static Byte`	`valueOf(byte b)`	Возвращает экземпляр `Byte` представляющий указанное значение `byte`.
`static Byte`	`valueOf(String s)`	Возвращает объект `Byte`, содержащий значение, полученное из указанного `String`.
`static Byte`	`valueOf(String s, int radix)`	Возвращает объект `Byte`, содержащий значение, извлеченное из указанного `String` при парсинге с указанной системой счисления.

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

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

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

MIN_VALUE

public static final byte MIN_VALUE

Постоянная, хранящая минимальное значение, которое может иметь %, -2⁷.

См. также:

Значения константных полей

MAX_VALUE

public static final byte MAX_VALUE

Постоянная, хранящая максимальное значение, которое может иметь %, 2⁷-1.

См. также:

Значения константных полей

TYPE

public static final Class<Byte> TYPE

Экземпляр %, представляющий примитивный тип byte.

SIZE

public static final int SIZE

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

С момента:

1.5

См. также:

Значения константных полей

BYTES

public static final int BYTES

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

С момента:

1.8

См. также:

Значения константных полей

Подробное описание конструкторов

Byte

@Deprecated(since="9", forRemoval=true) public Byte(byte value)

Устарело, для удаления: Этот элемент API может быть удален в будущей версии.

Редко уместно использовать этот конструктор. Статический фабричный метод valueOf(byte) обычно является лучшим выбором, так как он, вероятно, обеспечит значительно лучшие показатели производительности по памяти и времени.

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

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

Byte

@Deprecated(since="9", forRemoval=true) public Byte(String s) throws NumberFormatException

Устарело, для удаления: Этот элемент API может быть удален в будущей версии.

Редко уместно использовать этот конструктор. Используйте parseByte(String) для преобразования строки в примитивное значение %, или valueOf(String) для преобразования строки в объект Byte.

Создает новый объект %, представляющий значение %, указанное параметром String. Строка преобразуется в значение byte точно так же, как метод parseByte для основания 10.

Параметры:: s - строка, которая должна быть преобразована в значение Byte
Исключения:: NumberFormatException - если строка не содержит разборного byte.

Подробное описание методов

toString

public static String toString(byte b)

Возвращает новый объект String , представляющий указанное значение byte. Основание предполагается равным 10.

Параметры:

b - значение byte для преобразования

Возвращает:

строковое представление указанного значения byte

См. также:

Integer.toString(int)

describeConstable

public Optional<DynamicConstantDesc<Byte>> describeConstable()

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

Определено в:: describeConstable в интерфейсе Constable
Возвращает:: a Optional, описывающий экземпляр Byte
С момента:: 15

valueOf

public static Byte valueOf(byte b)

Возвращает экземпляр %, представляющий указанное значение byte. Если новый экземпляр Byte не требуется, этот метод, как правило, следует использовать вместо конструктора Byte(byte), так как этот метод, вероятно, обеспечит значительно лучшие показатели производительности по памяти и времени, так как все значения байтов кэшируются.

Параметры:: b - значение типа байт.
Возвращает:: экземпляр %, представляющий b.
С момента:: 1.5

parseByte

public static byte parseByte(String s, int radix) throws NumberFormatException

Анализирует строковый аргумент как целое со знаком byte в заданном основанием, указанном вторым аргументом. Символы в строке должны быть цифрами заданного основания (как определено тем, возвращает ли Character.digit(char, int) неотрицательное значение), за исключением того, что первый символ может быть ASCII-знаком минус '-' ('\u002D') для указания отрицательного значения или ASCII-знаком плюс '+' ('\u002B') для указания положительного значения. Возвращается полученное значение byte.

Исключение типа NumberFormatException выбрасывается, если происходит любое из следующих событий:

Первый аргумент пуст или имеет нулевую длину.
Основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
Любой символ строки не является цифрой заданного основания, за исключением того, что первый символ может быть знаком минус '-' ('\u002D') или знаком плюс '+' ('\u002B') при условии, что строка длиннее 1.
Значение, представленное строкой, не является значением типа byte.

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

parseByte

public static byte parseByte(String s) throws NumberFormatException

Анализирует строковый аргумент как целое со знаком десятичной системы


 byte

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

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

valueOf

public static Byte valueOf(String s, int radix) throws NumberFormatException

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

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

new Byte(Byte.parseByte(s, radix))

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

valueOf

public static Byte valueOf(String s) throws NumberFormatException

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

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

new Byte(Byte.parseByte(s))

Parameters:: s - строка, подлежащая парсингу
Returns:: объект Byte, содержащий значение, представленное аргументом-строкой
Throws:: NumberFormatException - Если String не содержит парсируемого byte.

decode

public static Byte decode(String nm) throws NumberFormatException

Декодирует String в Byte. Принимает десятичные, шестнадцатеричные и восьмеричные числа, заданные следующим грамматическим описанием:

ДекодируемаяСтрока:

Знак_{необязательно} ДесятичноеЧисло
Знак_{необязательно} 0x ШестнадцатеричныеЦифры
Знак_{необязательно} 0X ШестнадцатеричныеЦифры
Знак_{необязательно} # ШестнадцатеричныеЦифры
Знак_{необязательно} 0 ВосьмеричныеЦифры

Знак:

-
+

ДесятичноеЧисло, ШестнадцатеричныеЦифры и ВосьмеричныеЦифры определены в разделе 3.10.1 спецификации языка Java, за исключением того, что символы подчеркивания не допускаются между цифрами.

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

parseByte(java.lang.String, int)

byteValue

public byte byteValue()

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

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

shortValue

public short shortValue()

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

Overrides:: shortValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу short.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивных типов

intValue

public int intValue()

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

Specified by:: intValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу int.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивных типов

longValue

public long longValue()

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

Specified by:: longValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу long.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивных типов

floatValue

public float floatValue()

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

Specified by:: floatValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу float.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивных типов

doubleValue

public double doubleValue()

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

Specified by:: doubleValue в классе Number
Returns:: числовое значение, представленное этим объектом после преобразования к типу double.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивных типов

toString

public String toString()

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

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

hashCode

public int hashCode()

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

Overrides:

hashCode в классе Object

Returns:

значение кода хеширования для этого Byte

See Also:

hashCode

public static int hashCode(byte value)

Возвращает код хеширования для значения типа byte; совместимый с Byte.hashCode().

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

equals

public boolean equals(Object obj)

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

Overrides:

equals в классе Object

Parameters:

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

Returns:

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

See Also:

compareTo

public int compareTo(Byte anotherByte)

Числовое сравнение двух объектов типа Byte.

Specified by:: compareTo в интерфейсе Comparable<Byte>
Parameters:: anotherByte - объект Byte для сравнения.
Returns:: значение 0 если этот объект Byte равен аргументу Byte; значение меньше 0 если этот объект Byte численно меньше аргумента Byte; и значение больше 0 если этот объект Byte численно больше аргумента Byte (с учётом знака).
Since:: 1.2

compare

public static int compare(byte x, byte y)

Числовое сравнение двух значений типа byte. Возвращаемое значение идентично тому, что вернулось бы при выполнении:

    Byte.valueOf(x).compareTo(Byte.valueOf(y))

Parameters:: x - первое значение типа byte для сравнения; y - второе значение типа byte для сравнения
Returns:: значение 0 если x == y; значение меньше 0 если x < y; и значение больше 0 если x > y
Since:: 1.7

compareUnsigned

public static int compareUnsigned(byte x, byte y)

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

Параметры:: x - первое значение типа byte для сравнения; y - второе значение типа byte для сравнения
Возвращает:: значение 0, если x == y; значение меньше 0, если x < y в качестве беззнаковых значений; и значение больше 0, если x > y в качестве беззнаковых значений
С:: 9

toUnsignedInt

public static int toUnsignedInt(byte x)

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


 byte

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

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

toUnsignedLong

public static long toUnsignedLong(byte x)

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


 byte

отображаются на значение 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/Byte.html