- 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
に、String
をbyte
に、そしてbyte
を扱うときに有用な他の定数およびメソッドに変換するいくつかのメソッドを提供します。
-
-
メソッドのサマリー
修飾子と型 メソッド 説明 byte
byteValue()
このByte
の値をbyte
として返します。static int
compare(byte x, byte y)
2つのbyte
値を数値的に比較します。int
compareTo(Byte anotherByte)
2つのByte
オブジェクトを数値的に比較します。static int
compareUnsigned(byte x, byte y)
値を数値として扱う2つのbyte
値を符号なしとして比較します。static Byte
decode(String nm)
String
をByte
にデコードします。double
doubleValue()
このByte
の拡張プリミティブ変換後の値をdouble
として返します。boolean
equals(Object obj)
このオブジェクトを指定されたオブジェクトと比較します。float
floatValue()
このByte
の拡張プリミティブ変換後の値をfloat
として返します。int
hashCode()
このByte
のハッシュ・コード(intValue()
を呼び出した場合の結果と等しくなる)を返します。static int
hashCode(byte value)
Byte.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 int
toUnsignedInt(byte x)
符号なし変換によって、その引数をint
に変換します。static long
toUnsignedLong(byte x)
符号なし変換によって、その引数をlong
に変換します。static Byte
valueOf(byte b)
指定されたbyte
値を表すByte
インスタンスを返します。static Byte
valueOf(String s)
特定のString
により指定された値を保持するByte
オブジェクトを返します。static Byte
valueOf(String s, int radix)
2番目の引数で指定された基数を使用した構文解析時に、指定されたString
から抽出された値を保持するByte
オブジェクトを返します。
-
-
-
フィールドの詳細
-
MIN_VALUE
public static final byte MIN_VALUE
byte
に設定可能な最小値 -27を保持する定数。- 関連項目:
- 定数フィールド値
-
MAX_VALUE
public static final byte MAX_VALUE
byte
に設定可能な最大値27-1を保持する定数。- 関連項目:
- 定数フィールド値
-
SIZE
public static final int SIZE
2の補数バイナリ形式でbyte
値を表すのに使用されるビット数。- 導入されたバージョン:
- 1.5
- 関連項目:
- 定数フィールド値
-
BYTES
public static final int BYTES
2の補数バイナリ形式でbyte
値を表すために使用されるバイト数。- 導入されたバージョン:
- 1.8
- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
Byte
@Deprecated(since="9") public Byte(byte value)
非推奨。このコンストラクタを使用することはほとんどありません。 静的ファクトリvalueOf(byte)
は、より良いスペースと時間のパフォーマンスをもたらす可能性が高いため、通常はより良い選択です。指定されたbyte
値を表す、新しく割り当てられたByte
オブジェクトを構築します。- パラメータ:
value
-Byte
によって表される値。
-
Byte
@Deprecated(since="9") public Byte(String s) throws NumberFormatException
非推奨。このコンストラクタを使用することはほとんどありません。 文字列をbyte
プリミティブに変換するにはparseByte(String)
を使用し、文字列をByte
オブジェクトに変換するにはvalueOf(String)
を使用します。String
パラメータで示されるbyte
値を表す、新しく割り当てられたByte
オブジェクトを構築します。 文字列は、基数10でparseByte
メソッドを使用するのと同じようにbyte
値に変換されます。- パラメータ:
s
-Byte
に変換するString
- 例外:
NumberFormatException
-String
が解析可能なbyte
を含まない場合。
-
-
メソッドの詳細
-
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, int radix) throws NumberFormatException
2番目の引数に指定された基数をもとにして、文字列の引数を符号付きbyte
として構文解析します。 文字列内の文字はすべて、指定された基数の桁である必要があります(Character.digit(char, int)
から負でない値が返されるかどうかで判定)。ただし先頭の文字だけは、負の値を示すASCIIマイナス記号'-'
('\u002D'
)、正の値を示すASCIIプラス記号'+'
('\u002B'
)のどちらであってもかまいません。 結果として得られるbyte
値が返されます。以下に挙げる状況のどれかが発生した場合に、
NumberFormatException
型の例外がスローされます。- 1番目の引数が
null
であるか、長さゼロの文字列である。 - radixが
Character.MIN_RADIX
よりも小さいか、Character.MAX_RADIX
よりも大きい。 - 文字列の中に、指定された基数による桁には使えない文字がある。ただし、文字列の長さが1よりも大きい場合は、1番目の文字がマイナス記号
'-'
('\u002D'
)またはプラス記号'+'
('\u002B'
)であってもかまわない。 - 文字列によって表される値が、
byte
型の値ではない。
- パラメータ:
s
- 解析対象のbyte
表現を含むString
radix
- 解析時に使用する基数s
- 戻り値:
- 指定された基数での、文字列引数で表される
byte
値 - 例外:
NumberFormatException
- 文字列が解析可能なbyte
を含まない場合。
- 1番目の引数が
-
parseByte
public static byte parseByte(String s) throws NumberFormatException
文字列の引数を符号付き10進数byte
として構文解析します。 文字列内の文字はすべて、10進数の桁である必要があります。ただし先頭の文字だけは、負の値を示すASCIIマイナス記号'-'
('\u002D'
)、正の値を示すASCIIプラス記号'+'
('\u002B'
)のどちらであってもかまいません。 結果となるbyte
値が返されます。これは、その引数と基数10がparseByte(java.lang.String, int)
メソッドに引数として指定された場合とまったく同じです。- パラメータ:
s
- 解析対象のbyte
表現を含むString
- 戻り値:
- 10進数の引数で表される
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:
- Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits - Signopt
- Sign:
-
+
オプションの符号と基数指示子のどちらかまたはその両方に続く文字シーケンス(
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
として返します。
-
shortValue
public short shortValue()
このByte
の拡張プリミティブ変換後の値をshort
として返します。- オーバーライド:
shortValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
short
型に変換した値。 - Java™言語仕様:
- 5.1.2 拡張プリミティブ変換
-
intValue
public int intValue()
このByte
の拡張プリミティブ変換後の値をint
として返します。
-
longValue
public long longValue()
このByte
の拡張プリミティブ変換後の値をlong
として返します。
-
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
オブジェクトを返します。 値は、符号付きの10進数表現に変換され、文字列として返されます。これは、byte
値がtoString(byte)
メソッドの引数として指定された場合とまったく同じです。
-
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.hashCode()
との互換性がある、byte
値のハッシュ・コードを返します。- パラメータ:
value
- ハッシュ対象の値- 戻り値:
byte
値のハッシュ・コード値。- 導入されたバージョン:
- 1.8
-
equals
public boolean equals(Object obj)
このオブジェクトを指定されたオブジェクトと比較します。 結果がtrue
になるのは、引数がnull
ではなく、このオブジェクトと同じbyte
値を含むByte
オブジェクトである場合だけです。- オーバーライド:
equals
、クラス:Object
- パラメータ:
obj
- 比較対象のオブジェクト- 戻り値:
- オブジェクトが同じである場合は
true
、そうでない場合はfalse
。 - 関連項目:
Object.hashCode()
、HashMap
-
compareTo
public int compareTo(Byte anotherByte)
2つのByte
オブジェクトを数値的に比較します。- 定義:
compareTo
、インタフェース:Comparable<Byte>
- パラメータ:
anotherByte
- 比較対象のByte
。- 戻り値:
- この
Byte
が引数Byte
と等しい場合は値0
、このByte
が引数Byte
より小さい数値の場合は0
より小さい値、このByte
が引数Byte
より大きい数値の場合は0
より大きい値(符号付きの比較)。 - 導入されたバージョン:
- 1.2
-
compare
public static int compare(byte x, byte y)
2つのbyte
値を数値的に比較します。 返される値は、次から返される値と同じになります。Byte.valueOf(x).compareTo(Byte.valueOf(y))
- パラメータ:
x
- 比較する最初のbyte
y
- 比較する2番目のbyte
- 戻り値:
x == y
の場合は値0
、x < y
の場合は0
より小さい値、x> y
の場合は0
より大きい値- 導入されたバージョン:
- 1.7
-
compareUnsigned
public static int compareUnsigned(byte x, byte y)
値を数値として扱う2つのbyte
値を符号なしとして比較します。- パラメータ:
x
- 比較する最初のbyte
y
- 比較する2番目のbyte
- 戻り値:
x == y
の場合は値0
、符号なしの値としてx < y
の場合は0
より小さい値、符号なしの値としてx> y
の場合は0
より大きい値- 導入されたバージョン:
- 9
-
toUnsignedInt
public static int toUnsignedInt(byte x)
符号なし変換によって、その引数をint
に変換します。int
への符号なし変換では、int
の上位24ビットがゼロになり、下位8ビットがbyte
引数のビットに等しくなります。 その結果、ゼロおよび正のbyte
値は、数値的に等しいint
値にマッピングされ、負のbyte
値は、入力プラス2 8に等しいint
値にマッピングされます。- パラメータ:
x
- 符号なしint
に変換する値- 戻り値:
- 符号なし変換によって
int
に変換された引数 - 導入されたバージョン:
- 1.8
-
toUnsignedLong
public static long toUnsignedLong(byte x)
符号なし変換によって、その引数をlong
に変換します。long
への符号なし変換では、long
の上位56ビットがゼロになり、下位8ビットがbyte
引数のビットに等しくなります。 結果として、ゼロおよび正のbyte
値は、数値的に等しいlong
値にマッピングされ、負のbyte
値は、入力+2 8に等しいlong
値にマッピングされます。- パラメータ:
x
- 符号なしlong
に変換する値- 戻り値:
- 符号なし変換によって
long
に変換された引数 - 導入されたバージョン:
- 1.8
-
-