Класс Byte

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

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

Поля

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

public Byte(byte value)

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

Параметры:

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

Byte

public Byte(String s)
     throws NumberFormatException

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

Параметры:

s - строка, которая будет преобразована в значение типа String

Исключения:

NumberFormatException - Если строка не содержит разбираемого значения типа byte.

См. также:

parseByte(java.lang.String, int)

Методы

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), так как он, вероятно, обеспечит значительно лучшую производительность по памяти и времени, поскольку все значения типа byte кешируются.

Параметры:

b - значение типа byte.

Возвращаемое значение:

экземпляр типа Byte, представляющий b.

С тех пор:

1.5

parseByte

public static byte parseByte(String s,
                             int radix)
                      throws NumberFormatException

Параметры:

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

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

Параметры:

s - строка для парсинга

radix - основание для интерпретации s

Возвращаемое значение:

Объект типа Byte , содержащий значение, представленное строкой-аргументом в указанной системе счисления.

Исключения:

NumberFormatException - Если строка не содержит разбираемого значения типа byte.

valueOf

public static Byte valueOf(String s)
                    throws NumberFormatException

new Byte(Byte.parseByte(s))

Параметры:

s - строка для парсинга

Возвращаемое значение:

Объект типа Byte , содержащий значение, представленное строкой-аргументом

Исключения:

NumberFormatException - Если строка не содержит разбираемого значения типа byte.

decode

public static Byte decode(String nm)
                   throws NumberFormatException

Параметры:

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

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