Byte (Java 2 Platform SE 5.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.lang
クラス Byte

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

すべての実装されたインタフェース:: Serializable, Comparable<Byte>

public final class Byte
extends Number
implements Comparable<Byte>
extends Number
implements Comparable<Byte>

Byte クラスは、プリミティブ型 byte の値をオブジェクト内にラップします。Byte 型のオブジェクトには、byte 型の単一のフィールドがあります。

さらにこのクラスは、byte を String に、String を byte に変換する各種メソッドや、byte の処理時に役立つ定数およびメソッドも提供します。

導入されたバージョン:: JDK1.1
関連項目:: Number, 直列化された形式

フィールドの概要
`static byte`	`MAX_VALUE` `byte` に設定可能な最大値 (2⁷-1) を保持する定数
`static byte`	`MIN_VALUE` `byte` に設定可能な最小値 (-2⁷) を保持する定数
`static int`	`SIZE` 2 の補数バイナリ形式で `byte` 値を表すのに使用されるビット数
`static Class<Byte>`	`TYPE` `byte` のプリミティブ型を表す `Class` インスタンス

コンストラクタの概要
`Byte(byte value)` 指定された `byte` 値を表す、新しく割り当てられた `Byte` オブジェクトを構築します。
`Byte(String s)` `String` パラメータで示される `byte` 値を表す、新しく割り当てられた `Byte` オブジェクトを構築します。

メソッドの概要
`byte`	`byteValue()` この `Byte` の値を `byte` として返します。
`int`	`compareTo(Byte anotherByte)` 2 つの `Byte` オブジェクトを数値的に比較します。
`static Byte`	`decode(String nm)` `String` を `Byte` にデコードします。
`double`	`doubleValue()` この `Byte` の値を `double` として返します。
`boolean`	`equals(Object obj)` このオブジェクトを指定されたオブジェクトと比較します。
`float`	`floatValue()` この `Byte` の値を `float` として返します。
`int`	`hashCode()` `Byte` のハッシュコードを返します。
`int`	`intValue()` この `Byte` の値を `int` として返します。
`long`	`longValue()` この `Byte` の値を `long` として返します。
`static byte`	`parseByte(String s)` 文字列の引数を符号付き 10 進数の `byte` 型として構文解析します。
`static byte`	`parseByte(String s, int radix)` 2 番目の引数に指定された基数をもとにして、文字列の引数を符号付き `byte` として構文解析します。
`short`	`shortValue()` この `Byte` の値を `short` として返します。
`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)` 2 番目の引数で指定された基数を使用した構文解析時に、指定された `String` から抽出された値を保持する `Byte` オブジェクトを返します。

クラス java.lang.Object から継承されたメソッド
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

フィールドの詳細

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

2 の補数バイナリ形式で byte 値を表すのに使用されるビット数

導入されたバージョン:: 1.5
関連項目:: 定数フィールド値

コンストラクタの詳細

Byte

public Byte(byte value)

指定された byte 値を表す、新しく割り当てられた Byte オブジェクトを構築します。

パラメータ:: value - Byte によって表される値

Byte

public Byte(String s)
     throws NumberFormatException

String パラメータで示される byte 値を表す、新しく割り当てられた 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 - バイト値
戻り値:: b を表す Byte インスタンス
導入されたバージョン:: 1.5

parseByte

public static byte parseByte(String s)
                      throws NumberFormatException

文字列の引数を符号付き 10 進数の byte 型として構文解析します。文字列にある文字はすべて、10 進数でなければなりません。ただし、1 番目の文字だけは、負の値を表すためにマイナス記号の ASCII 文字「-」(「\u002D」) であってもかまいません。以上の結果生成された byte 値が返されます。これは、この引数と基数 10 が parseByte(java.lang.String, int) メソッドに引数として指定された場合とまったく同じです。

パラメータ:: s - 構文解析対象の byte 表現を含む String
戻り値:: 10 進数の引数で表される byte 値
例外:: NumberFormatException - 文字列に構文解析可能な byte 値が含まれない場合

parseByte

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

2 番目の引数に指定された基数をもとにして、文字列の引数を符号付き byte として構文解析します。文字列にある文字はすべて、指定された基数の桁に使う数字でなければなりません。これは、Character.digit(char, int) が負ではない値を返すかどうかによって調べることができます。ただし、1 番目の文字だけは、負の値を表すためにマイナス記号の ASCII 文字「-」(「\u002D」) であってもかまいません。以上の結果生成された byte 値が返されます。

以下に挙げる状況のどれかが発生した場合に、NumberFormatException 型の例外がスローされます。

1 番目の引数が null であるか、長さゼロの文字列である
基数が Character.MIN_RADIX よりも小さいか、Character.MAX_RADIX よりも大きい
文字列の中に、指定された基数による桁には使えない文字がある。ただし、文字列の長さが 1 よりも大きい場合は、1 番目の文字がマイナス記号「-」(「\u002d」) であってもかまわない
文字列によって表される値が、byte 型の値ではない

パラメータ:: s - 構文解析対象の byte 表現を含む String; radix - s の構文解析時に使用する基数
戻り値:: 指定された基数での、文字列引数で表される byte 値
例外:: NumberFormatException - 文字列に構文解析可能な byte 値が含まれない場合

valueOf

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

2 番目の引数で指定された基数を使用した構文解析時に、指定された String から抽出された値を保持する Byte オブジェクトを返します。最初の引数は、2 番目の引数で指定された基数内の符号付き 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

指定された String により設定された値を保持する Byte オブジェクトを返します。引数は、符号付き 10 進数の 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 にデコードします。以下の文法の 10 進数、16 進数、および 8 進数を指定できます。

DecodableString:
Sign_opt DecimalNumeral
Sign_opt 0x HexDigits
Sign_opt 0X HexDigits
Sign_opt # HexDigits
Sign_opt 0 OctalDigits

Sign:
-

DecimalNumeral、HexDigits、および OctalDigits は、『Java 言語仕様』の §3.10.1 で定義されています。

負の符号 (オプション) と基数指示子のどちらかまたはその両方に続く文字シーケンス (「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()

この Byte の値を short として返します。

オーバーライド:: クラス Number 内の shortValue

戻り値:: このオブジェクトが表す数値を short 型に変換した値

intValue

public int intValue()

この Byte の値を int として返します。

定義:: クラス Number 内の intValue

戻り値:: このオブジェクトが表す数値を int 型に変換した値

longValue

public long longValue()

この Byte の値を long として返します。

定義:: クラス Number 内の longValue

戻り値:: このオブジェクトが表す数値を long 型に変換した値

floatValue

public float floatValue()

この Byte の値を float として返します。

定義:: クラス Number 内の floatValue

戻り値:: このオブジェクトが表す数値を float 型に変換した値

doubleValue

public double doubleValue()

この Byte の値を double として返します。

定義:: クラス Number 内の doubleValue

戻り値:: このオブジェクトが表す数値を double 型に変換した値

toString

public String toString()

この Byte の値を表す String オブジェクトを返します。値は、符号付きの 10 進数表現に変換され、文字列として返されます。これは、byte 値が toString(byte) メソッドの引数として指定された場合とまったく同じです。

オーバーライド:: クラス Object 内の toString

戻り値:: このオブジェクトの 10 進数 (基数 10) による文字列表現

hashCode

public int hashCode()

Byte のハッシュコードを返します。

オーバーライド:: クラス Object 内の hashCode

戻り値:: このオブジェクトのハッシュコード値
関連項目:: Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

このオブジェクトを指定されたオブジェクトと比較します。結果が true になるのは、引数が null ではなく、このオブジェクトと同じ byte 値を含む Byte オブジェクトである場合だけです。

オーバーライド:: クラス Object 内の equals

パラメータ:: obj - 比較対象のオブジェクト
戻り値:: オブジェクトが同じである場合は true、そうでない場合は false
関連項目:: Object.hashCode(), Hashtable

compareTo

public int compareTo(Byte anotherByte)

2 つの Byte オブジェクトを数値的に比較します。

定義:: インタフェース Comparable<Byte> 内の compareTo

パラメータ:: anotherByte - 比較対象の Byte
戻り値:: この Byte が引数 Byte と等しい場合は値 0。この Byte が引数 Byte より小さい数値の場合は 0 より小さい値。この Byte が引数 Byte より大きい数値の場合は 0 より大きい値 (符号付きの比較)
導入されたバージョン:: 1.2