模块 java.base

包 java.lang

类 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 时有用的其他常量和方法。

这是一个value-based类；程序员应该将 equal 的实例视为可互换的，并且不应使用实例进行同步，否则可能会发生不可预测的行为。例如，在未来的版本中，同步可能会失败。

自从：

1.1

参见：

• Number
• Serialized Form

字段摘要

字段

修饰符和类型	Field	描述
static final int	BYTES	用于表示二进制补码形式的 byte 值的字节数。
static final byte	MAX_VALUE	一个保持最大值的常量 byte 可以有，27-1.
static final byte	MIN_VALUE	一个保持最小值的常数 a byte 可以有，-27.
static final int	SIZE	用于以二进制补码形式表示 byte 值的位数。
static final Class<Byte>	TYPE	代表原始类型 byte 的 Class 实例。

构造方法总结

构造方法

构造方法	描述
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()	返回表示此 Byte 值的 String 对象。
static String	toString(byte b)	返回表示指定 byte 的新 String 对象。
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
            

一个保持最小值的常数 a byte 可以有，-2⁷.

参见：

• 常量字段值

MAX_VALUE

public static final byte MAX_VALUE
            

一个保持最大值的常量 byte 可以有，2⁷-1.

参见：

• 常量字段值

TYPE

public static final Class <Byte > TYPE
            

代表原始类型 byte 的 Class 实例。

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 对象，该对象表示 String 参数指示的 byte 值。字符串转换为 byte 值的方式与 parseByte 方法用于基数 10 的方式完全相同。

参数：

s - 要转换为 Byte 的 String

抛出：

NumberFormatException - 如果 String 不包含可解析的 byte 。

方法详情

toString

public static String  toString(byte b)
            

返回表示指定 byte 的新 String 对象。假定基数为 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) ，因为此方法可能会产生明显更好的空间和时间性能，因为所有字节值都已缓存。

参数：

b - 一个字节值。

返回：

代表 b 的 Byte 实例。

自从：

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 表示的 String

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 表示的 String

返回：

参数表示的 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 - 如果 String 不包含可解析的 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 - 如果 String 不包含可解析的 byte。

decode

public static Byte  decode(String  nm) throws NumberFormatException 
            

将 String 解码为 Byte 。接受由以下语法给出的十进制、十六进制和八进制数：

可解码字符串：

符号_选择 DecimalNumeral

符号_选择 0x HexDigits

符号_选择 0X HexDigits

符号_选择 # HexDigits

符号_选择 0 OctalDigits

符号：

-

+

DecimalNumeral, HexDigits， 和OctalDigits的定义见 3.10.1 节Java 语言规范, 除了数字之间不接受下划线。

可选符号和/或基数说明符（“0x”、“0X”、“#”或前导零）后面的字符序列由具有指定基数（10、16 或 8）的 Byte.parseByte 方法解析。此字符序列必须表示正值，否则将抛出 NumberFormatException 。如果指定的 String 的第一个字符是减号，则结果取反。 String 中不允许有空白字符。

参数：

nm - 要解码的 String。

返回：

一个 Byte 对象持有由 nm 表示的 byte 值

抛出：

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()
            

返回表示此 Byte 值的 String 对象。该值被转换为带符号的十进制表示形式并作为字符串返回，就像将 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)
            

将此对象与指定对象进行比较。当且仅当参数不是 null 并且是包含与该对象相同的 byte 值的 Byte 对象时，结果为 true。

重写：

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 ；如果 x < y 小于 0 的值；如果 x > y，则值大于 0

自从：

1.7

compareUnsigned

public static int compareUnsigned(byte x, byte y)
            

比较两个 byte 值，在数值上将值视为无符号。

参数：

x - 第一个要比较的 byte

y - 要比较的第二个 byte

返回：

值 0 如果 x == y ；如果 x < y 为无符号值，则小于 0 的值；如果 x > y 为无符号值，则值大于 0

自从：

9

toUnsignedInt

public static int toUnsignedInt(byte x)
            

通过无符号转换将参数转换为 int。在到 int 的无符号转换中，int 的高 24 位为零，低 8 位等于 byte 参数的位。因此，零和正 byte 值映射到数值上相等的 int 值，负 byte 值映射到等于输入加 2 的 int 值⁸.

参数：

x - 要转换为无符号 int 的值

返回：

通过无符号转换将参数转换为 int

自从：

1.8

toUnsignedLong

public static long toUnsignedLong(byte x)
            

通过无符号转换将参数转换为 long。在到 long 的无符号转换中，long 的高 56 位为零，低 8 位等于 byte 参数的位。因此，零和正 byte 值映射到数值上相等的 long 值，负 byte 值映射到等于输入加 2 的 long 值⁸.

参数：

x - 要转换为无符号 long 的值

返回：

通过无符号转换将参数转换为 long

自从：

1.8