JavaTM Platform
Standard Ed. 6

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 的字段。

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

从以下版本开始:
JDK1.1
另请参见:
Number, 序列化表格

字段摘要
static byte MAX_VALUE
          一个常量,保存 byte 类型可取的最大值,即 27-1。
static byte MIN_VALUE
          一个常量,保存 byte 类型可取的最小值,即 -27
static int SIZE
          用于以二进制补码形式表示 byte 值的位数。
static Class<Byte> TYPE
          表示基本类型 byteClass 实例。
 
构造方法摘要
Byte(byte value)
          构造一个新分配的 Byte 对象,以表示指定的 byte 值。
Byte(String s)
          构造一个新分配的 Byte 对象,以表示 String 参数所指示的 byte 值。
 
方法摘要
 byte byteValue()
          作为一个 byte 返回此 Byte 的值。
 int compareTo(Byte anotherByte)
          在数字上比较两个 Byte 对象。
static Byte decode(String nm)
          将 String 解码为 Byte
 double doubleValue()
          作为一个 double 返回此 Byte 的值。
 boolean equals(Object obj)
          将此对象与指定对象比较。
 float floatValue()
          作为一个 float 返回此 Byte 的值。
 int hashCode()
          返回此 Byte 的哈希码。
 int intValue()
          作为一个 int 返回此 Byte 的值。
 long longValue()
          作为一个 long 返回此 Byte 的值。
static byte parseByte(String s)
          将 string 参数解析为有符号的十进制 byte
static byte parseByte(String s, int radix)
          将 string 参数解析为一个有符号的 byte,其基数由第二个参数指定。
 short shortValue()
          作为一个 short 返回此 Byte 的值。
 String toString()
          返回表示此 Byte 的值的 String 对象。
static String toString(byte b)
          返回表示指定 byte 的一个新 String 对象。
static Byte valueOf(byte b)
          返回表示指定 byte 值的一个 Byte 实例。
static Byte valueOf(String s)
          返回一个保持指定 String 所给出的值的 Byte 对象。
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
表示基本类型 byteClass 实例。


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 - 要转换成 ByteString
抛出:
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 值。
返回:
表示 bByte 实例。
从以下版本开始:
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 类型的异常:

参数:
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:
Signopt DecimalNumeral
Signopt 0x HexDigits
Signopt 0X HexDigits
Signopt # HexDigits
Signopt 0 OctalDigits
Sign:
-
Java Language Specification§3.10.1 中给出了 DecimalNumeralHexDigitsOctalDigits 的定义。

对(可选)负号和/或基数说明符(“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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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