Класс 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)`	Устарел. Использовать этот конструктор обычно не следует.
`Byte(String s)`	Устарел. Использовать этот конструктор обычно не следует.

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

Модификатор и тип	Метод	Описание
`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` при разборе в системе счисления, заданной вторым аргументом.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарел, будет удалён: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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") public Byte(byte value)

Устарел.

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

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

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

Byte

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

Устарел.

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

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

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

NumberFormatException — если String не содержит разбираемого значения byte.

См. также:

byteValue

public byte byteValue()

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

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

shortValue

public short shortValue()

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

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

intValue

public int intValue()

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

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

longValue

public long longValue()

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

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

floatValue

public float floatValue()

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

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

doubleValue

public double doubleValue()

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

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

toString

public String toString()

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

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

hashCode

public int hashCode()

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

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этого Byte

См. также:

hashCode

public static int hashCode(byte value)

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

Параметры:: value — значение, для которого вычисляется хеш-код
Возвращает:: значение хеш-кода для значения byte.
Начиная с версии:: 1.8

equals

public boolean equals(Object obj)

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

Переопределяет:

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

compareTo

public int compareTo(Byte anotherByte)

Сравнивает два объекта Byte численно.

Определен в:: compareTo в интерфейсе Comparable<Byte>
Параметры:: anotherByte — объект Byte для сравнения.
Возвращает:: значение 0, если этот Byte равен аргументу Byte; значение меньше 0, если этот Byte численно меньше аргумента Byte; и значение больше 0, если этот Byte численно больше аргумента Byte (сравнение со знаком).
Начиная с версии:: 1.2

compare

public static int compare(byte x, byte y)

Сравнивает два значения byte численно. Возвращаемое значение совпадает со значением, которое вернуло бы выражение:

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

Параметры:: x — первое значение byte для сравнения; y — второе значение byte для сравнения
Возвращает:: значение 0, если x == y; значение меньше 0, если x < y; и значение больше 0, если x > y
Начиная с версии:: 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, 2025, 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.