Spec-Zone.ru › OpenJDK 25

Класс 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
См. также:
  • Number
  • Сериализованное представление

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

Модификатор и тип Поле Описание
static final int BYTES
Количество байтов, используемых для представления значения byte в двоичной форме с дополнительным кодом.
static final byte MAX_VALUE
Константа, содержащая максимальное значение, которое может иметь byte: 27-1.
static final byte MIN_VALUE
Константа, содержащая минимальное значение, которое может иметь byte: -27.
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

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

MIN_VALUE

public static final byte MIN_VALUE
Константа, содержащая минимальное значение, которое может иметь byte: -27.
См. также:
  • Значения константных полей

MAX_VALUE

public static final byte MAX_VALUE
Константа, содержащая максимальное значение, которое может иметь byte: 27-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
См. также:
  • Integer.toString(int)

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. Поддерживаются десятичные, шестнадцатеричные и восьмеричные числа, соответствующие следующей грамматике:
DecodableString:
Signopt DecimalNumeral
Signopt 0x HexDigits
Signopt 0X HexDigits
Signopt # HexDigits
Signopt 0 OctalDigits
Sign:
-
+
DecimalNumeral, HexDigits и OctalDigits определены в разделе 3.10.1 Спецификации языка Java, за исключением того, что между цифрами не допускаются символы подчеркивания.

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

Параметры:
nm — String для декодирования.
Возвращает:
объект Byte, содержащий значение byte, представленное nm
Исключения:
NumberFormatException — если String не содержит разбираемое значение byte.
См. также:
  • parseByte(java.lang.String, int)

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
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

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.
См. также:
  • Object.hashCode()
  • HashMap

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, равные исходному значению плюс 28.
Параметры:
x — значение, которое необходимо преобразовать в беззнаковое int
Возвращает:
аргумент, преобразованный в int с помощью беззнакового преобразования
Начиная с:
1.8

toUnsignedLong

public static long toUnsignedLong(byte x)
Преобразует аргумент в long с помощью беззнакового преобразования. При беззнаковом преобразовании в long старшие 56 бит long равны нулю, а младшие 8 бит совпадают с битами аргумента byte. Следовательно, нулевые и положительные значения byte преобразуются в численно равные значения long, а отрицательные значения byte преобразуются в значения long, равные исходному значению плюс 28.
Параметры:
x — значение, которое необходимо преобразовать в беззнаковое long
Возвращает:
аргумент, преобразованный в long с помощью беззнакового преобразования
Начиная с:
1.8

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Byte.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API