Класс Byte

Все реализованные интерфейсы:
Serializable, Comparable<Byte> 
public final class Byte
extends Number
implements Comparable<Byte>

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

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

С тех пор:
1.1
См. также:
Number, Сериализованная форма

Поля

Модификатор и тип Поле Описание
static int BYTES

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

Константа, содержащая максимальное значение, которое может иметь byte: 27-1.
static byte MIN_VALUE

Константа, содержащая минимальное значение, которое может иметь byte: -27.
static int SIZE

Количество битов, используемых для представления значения byte в двоичной форме со знаком.
static 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.
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")
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
Исключения:
NumberFormatException - если строка не содержит анализируемого значения String.

Методы

toString

public static String toString(byte b)

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

Параметры:
b - преобразуемое byte
Возвращает:
строковое представление указанного byte
См. также:
Integer.toString(int)

valueOf

public static Byte valueOf(byte b)

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

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

new Byte(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, равный значению:

new Byte(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 не допускаются пробелы.

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

byteValue

public byte byteValue()

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

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

shortValue

public short shortValue()

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

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

intValue

public int intValue()

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

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

longValue

public long longValue()

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

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

floatValue

public float floatValue()

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

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

doubleValue

public double doubleValue()

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

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

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, 2020, 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/11/docs/api/java.base/java/lang/Byte.html

Spec-Zone .ru
спецификации, руководства, описания, API