Spec-Zone.ru › OpenJDK 24

Класс 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)
Устарел, для удаления: Этот элемент 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
Константа, хранящая минимальное значение, которое может принимать 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", 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
См. также:
  • 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 - строка, содержащая строковое представление 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, содержащий значение, извлечённое из заданной строки 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 - Если строка 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.
См. также:
  • 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(java.lang.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

© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Byte.html

Spec-Zone.ru

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