JavaTM 2 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 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only