Класс 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` при парсинге с указанной основой вторым аргументом.

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

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

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

MIN_VALUE

public static final byte MIN_VALUE

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

См. также:

MAX_VALUE

public static final byte MAX_VALUE

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

См. также:

TYPE

public static final Class<Byte> TYPE

Экземпляр Class, представляющий примитивный тип 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 , представляющий указанное значение byte.

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

Byte

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

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

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

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

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

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

toString

public static String toString(byte b)

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

Параметры:

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

Возвращает:

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

См. также:

describeConstable

public Optional<DynamicConstantDesc<Byte>> describeConstable()

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

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

valueOf

public static Byte valueOf(byte b)

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

Параметры:: b - значение типа byte.
Возвращает:: экземпляр Byte , представляющий 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 выбрасывается, если возникает какая-либо из следующих ситуаций:

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

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

valueOf

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

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

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

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

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

valueOf

public static Byte valueOf(String s) throws NumberFormatException

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

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

Byte.valueOf(Byte.parseByte(s))

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

Returns:

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

Throws:

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

See Also:

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

См. Также:

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 в противном случае.

См. Также:

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

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

toUnsignedInt

public static int toUnsignedInt(byte x)

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


 byte

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

Parameters:: x - значение для преобразования в беззнаковое int
Returns:: аргумент, преобразованный в int с помощью беззнакового преобразования
Since:: 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, 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/Byte.html