java.lang
类 Byte

java.lang.Object
  java.lang.Number
      java.lang.Byte

所有已实现的接口：

Serializable, Comparable<Byte>

public final class Byte
extends Number
implements Comparable<Byte>

Byte 类将基本类型 byte 的值包装在一个对象中。一个 Byte 类型的对象只包含一个类型为 byte 的字段。

此外，该类还为 byte 和 String 的相互转换提供了几种方法，并提供了处理 byte 时非常有用的其他一些常量和方法。

从以下版本开始：

JDK1.1

另请参见：

Number, 序列化表格

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

表示基本类型 byte 的 Class 实例。

SIZE

public static final int SIZE

用于以二进制补码形式表示 byte 值的位数。

从以下版本开始：

1.5

另请参见：

常量字段值

Byte

public Byte(byte value)

构造一个新分配的 Byte 对象，以表示指定的 byte 值。

参数：

value - Byte 对象所表示的值。

Byte

public Byte(String s)
     throws NumberFormatException

构造一个新分配的 Byte 对象，以表示 String 参数所指示的 byte 值。该字符串以使用基数 10 的 parseByte 方法所使用的方式被转换成一个 byte 值。

参数：

s - 要转换成 Byte 的 String

抛出：

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

另请参见：

parseByte(java.lang.String, int)

toString

public static String toString(byte b)

返回表示指定 byte 的一个新 String 对象。假定基数为 10。

参数：

b - 要转换的 byte

返回：

指定 byte 的字符串表示形式

另请参见：

Integer.toString(int)

valueOf

public static Byte valueOf(byte b)

返回表示指定 byte 值的一个 Byte 实例。如果不需要新的 Byte 实例，则通常应优先使用此方法，而不是构造方法 Byte(byte)，因为该方法有可能通过缓存经常请求的值来显著提高空间和时间性能。

参数：

b - 一个 byte 值。

返回：

表示 b 的 Byte 实例。

从以下版本开始：

1.5

parseByte

public static byte parseByte(String s)
                      throws NumberFormatException

将 string 参数解析为有符号的十进制 byte。除了第一个字符可以是表示负值的 ASCII 负号 '-' ('\u002D') 之外，该字符串中的字符必须都是十进制数字。返回得到的 byte 值与以该 string 参数和基数 10 为参数的 parseByte(java.lang.String, int) 方法所返回的值一样。

参数：

s - 要解析的包含 byte 表示形式的 String

返回：

以十进制的参数表示的 byte 值

抛出：

NumberFormatException - 如果该 string 不包含一个可解析的 byte。

parseByte

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

将 string 参数解析为一个有符号的 byte，其基数由第二个参数指定。除了第一个字符可以是表示负值的 ASCII 负号 '-' ('\u002D') 之外（这取决于 Character.digit(char, int) 是否返回非负值），该 string 中的字符必须都是指定基数的数字。返回得到的 byte 值。

如果出现下列任何一种情况，则抛出一个 NumberFormatException 类型的异常：

• 第一个参数为 null 或是一个长度为零的字符串。
• 基数小于 Character.MIN_RADIX 或者大于 Character.MAX_RADIX。
• 字符串的任一字符不是指定基数的数字，第一个字符是负号 '-' ('\u002D') 的情况除外（但此时字符串的长度应超过 1）。
• 字符串所表示的值不是 byte 类型的值。

参数：

s - 要解析的包含 byte 表示形式的 String

radix - 在解析 s 时使用的基数

返回：

以指定基数表示的 string 参数所表示的 byte 值

抛出：

NumberFormatException - 如果该 string 不包含一个可解析的 byte。

valueOf

public static Byte valueOf(String s,
                           int radix)
                    throws NumberFormatException

返回一个 Byte 对象，该对象保持从指定的 String 中提取的值，该值是在用第二个参数所给定的基数对指定字符串进行解析时提取的。第一个参数被解释为用第二个参数所指定的基数表示一个有符号的 byte，正如将该参数指定给 parseByte(java.lang.String, int) 方法一样。结果是一个表示该 string 所指定的 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

返回一个保持指定 String 所给出的值的 Byte 对象。参数被解释为表示一个有符号的十进制的 byte，正如将该参数指定给 parseByte(java.lang.String) 方法一样。结果是一个表示该 string 所指定的 byte 值的 Byte 对象。

换句话说，该方法返回一个等于以下代码的值的 Byte 对象：

new Byte(Byte.parseByte(s))

参数：

s - 要解析的字符串

返回：

保持 string 参数所表示的值的 Byte 对象

抛出：

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

decode

public static Byte decode(String nm)
                   throws NumberFormatException

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

DecodableString:

Sign_opt DecimalNumeral

Sign_opt 0x HexDigits

Sign_opt 0X HexDigits

Sign_opt # HexDigits

Sign_opt 0 OctalDigits

Sign:

-

Java Language Specification 的 §3.10.1 中给出了 DecimalNumeral、HexDigits 和 OctalDigits 的定义。

对（可选）负号和/或基数说明符（“0x”、“0X”、“#” 或前导零）后面的字符序列进行解析就如同使用带指定基数（10、16 或 8）的 Byte.parseByte 方法一样。该字符序列必须表示一个正值，否则将抛出 NumberFormatException。如果指定 String 的第一个字符是负号，则结果将被求反。该 String 中不允许出现空白字符。

参数：

nm - 要解码的 String。

返回：

保持由 nm 表示的 byte 值的 Byte 对象

抛出：

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

另请参见：

parseByte(java.lang.String, int)

byteValue

public byte byteValue()

作为一个 byte 返回此 Byte 的值。

覆盖：

类 Number 中的 byteValue

返回：

转换为 byte 类型后该对象表示的数值。

shortValue

public short shortValue()

作为一个 short 返回此 Byte 的值。

覆盖：

类 Number 中的 shortValue

返回：

转换为 short 类型后该对象表示的数值。

intValue

public int intValue()

作为一个 int 返回此 Byte 的值。

指定者：

类 Number 中的 intValue

返回：

转换为 int 类型后该对象表示的数值。

longValue

public long longValue()

作为一个 long 返回此 Byte 的值。

指定者：

类 Number 中的 longValue

返回：

转换为 long 类型后该对象表示的数值。

floatValue

public float floatValue()

作为一个 float 返回此 Byte 的值。

指定者：

类 Number 中的 floatValue

返回：

转换为 float 类型后该对象表示的数值。

doubleValue

public double doubleValue()

作为一个 double 返回此 Byte 的值。

指定者：

类 Number 中的 doubleValue

返回：

转换为 double 类型后该对象表示的数值。

toString

public String toString()

返回表示此 Byte 的值的 String 对象。该值被转换成有符号的十进制表示形式，并作为一个 string 返回，正如将 byte 值作为一个参数指定给 toString(byte) 方法所返回的一样。

覆盖：

类 Object 中的 toString

返回：

以基数 10 表示的此对象值的字符串表示形式。

hashCode

public int hashCode()

返回此 Byte 的哈希码。

覆盖：

类 Object 中的 hashCode

返回：

此对象的一个哈希码值。

另请参见：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

将此对象与指定对象比较。当且仅当参数不为 null，而是一个与此对象一样包含相同 Byte 值的 byte 对象时，结果才为 true。

覆盖：

类 Object 中的 equals

参数：

obj - 要进行比较的对象

返回：

如果这些对象相同，则为 true；否则为 false。

另请参见：

Object.hashCode(), Hashtable

compareTo

public int compareTo(Byte anotherByte)

在数字上比较两个 Byte 对象。

指定者：

接口 Comparable<Byte> 中的 compareTo

参数：

anotherByte - 要比较的 Byte。

返回：

如果此 Byte 等于参数 Byte，则返回 0；如果此 Byte 在数字上小于参数 Byte，则返回小于 0 的值；如果此 Byte 在数字上大于参数 Byte，则返回大于 0 的值（有符号比较）。

从以下版本开始：

1.2

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。