public final class Byte extends Number implements Comparable<Byte>
Byte
クラスは、プリミティブ型byte
の値をオブジェクトにラップします。 Byte
型のオブジェクトには、型がbyte
の単一フィールドが含まれます。
さらにこのクラスは、byte
をString
に、String
をbyte
に変換する各種メソッドや、byte
の処理時に役立つ定数およびメソッドも提供します。
修飾子と型 | フィールド | 説明 |
---|---|---|
static int |
BYTES |
2の補数バイナリ形式で
byte 値を表すために使用されるバイト数。 |
static byte |
MAX_VALUE |
byte に設定可能な最大値27-1を保持する定数。 |
static byte |
MIN_VALUE |
byte に設定可能な最小値 -27を保持する定数。 |
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 として返します。 |
static int |
compare(byte x, byte y) |
2つの
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 のハッシュ・コード(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 オブジェクトを返します。 |
public static final byte MIN_VALUE
byte
に設定可能な最小値 -27を保持する定数。public static final byte MAX_VALUE
byte
に設定可能な最大値27-1を保持する定数。public static final int SIZE
byte
値を表すのに使用されるビット数。public static final int BYTES
byte
値を表すために使用されるバイト数。public Byte(byte value)
byte
値を表す、新しく割り当てられたByte
オブジェクトを構築します。value
- Byte
によって表される値。public Byte(String s) throws NumberFormatException
String
パラメータで示されるbyte
値を表す、新しく割り当てられたByte
オブジェクトを構築します。 文字列は、基数10でparseByte
メソッドを使用するのと同じようにbyte
値に変換されます。 s
- Byte
に変換するString
NumberFormatException
- String
が解析可能なbyte
を含まない場合。parseByte(java.lang.String, int)
public static String toString(byte b)
byte
を表す新しいString
オブジェクトを返します。 基数は10と見なされます。 b
- 変換するbyte
byte
の文字列表現Integer.toString(int)
public static Byte valueOf(byte b)
byte
値を表すByte
インスタンスを返します。 新規Byte
インスタンスが不要な場合、通常このメソッドがコンストラクタByte(byte)
に優先して使用されます。その理由は、このメソッドではすべてのバイト値がキャッシュされるので、操作に必要な領域や時間がはるかに少なくて済む場合が多いためです。 b
- バイト値。b
を表すByte
インスタンス。public static byte parseByte(String s, int radix) throws NumberFormatException
byte
として構文解析します。 文字列内の文字はすべて、指定された基数の桁である必要があります(Character.digit(char, int)
から負でない値が返されるかどうかで判定)。ただし先頭の文字だけは、負の値を示すASCIIマイナス記号'-'
('\u002D'
)、正の値を示すASCIIプラス記号'+'
('\u002B'
)のどちらであってもかまいません。 結果として得られるbyte
値が返されます。
以下に挙げる状況のどれかが発生した場合に、NumberFormatException
型の例外がスローされます。
null
であるか、長さゼロの文字列である。
Character.MIN_RADIX
よりも小さいか、Character.MAX_RADIX
よりも大きい。
'-'
('\u002D'
)またはプラス記号'+'
('\u002B'
)であってもかまわない。
byte
型の値ではない。
s
- 解析対象のbyte
表現を含むString
radix
- 解析時に使用する基数s
byte
値NumberFormatException
- 文字列が解析可能なbyte
を含まない場合。public static byte parseByte(String s) throws NumberFormatException
byte
として構文解析します。 文字列内の文字はすべて、10進数の桁である必要があります。ただし先頭の文字だけは、負の値を示すASCIIマイナス記号'-'
('\u002D'
)、正の値を示すASCIIプラス記号'+'
('\u002B'
)のどちらであってもかまいません。 結果となるbyte
値が返されます。これは、その引数と基数10がparseByte(java.lang.String, int)
メソッドに引数として指定された場合とまったく同じです。 s
- 解析対象のbyte
表現を含むString
byte
値NumberFormatException
- 文字列が解析可能なbyte
を含まない場合。public static Byte valueOf(String s, int radix) throws NumberFormatException
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
を含まない場合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
を含まない場合public static Byte decode(String nm) throws NumberFormatException
String
をByte
にデコードします。 次の文法の10進数、16進数、および8進数を指定できます。
DecimalNumeral、HexDigits、およびOctalDigitsは、『Java™言語仕様』のセクション3.10.1で規定されているとおりですが、桁間のアンダースコアが受け入れられない点は規定と異なります。
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits- Sign:
-
+
オプションの符号と基数指示子のどちらかまたはその両方に続く文字シーケンス(「0x
」、「0X
」、「#
」、または先頭のゼロ)は、指定された基数(10、16、または8)でByte.parseByte
メソッドを使う場合と同じように構文解析されます。 この文字シーケンスは正の数でなければならず、そうでない場合はNumberFormatException
がスローされます。 指定されたString
の最初の文字が負の符号である場合、生成された結果は否定されます。 String
に空白文字を指定することはできません。
nm
- デコードするString
nm
により表されるbyte
値を保持するByte
オブジェクトNumberFormatException
- String
が解析可能なbyte
を含まない場合。parseByte(java.lang.String, int)
public byte byteValue()
Byte
の値をbyte
として返します。public short shortValue()
Byte
の拡張プリミティブ変換後の値をshort
として返します。shortValue
、クラスNumber
short
型に変換した値。public int intValue()
Byte
の拡張プリミティブ変換後の値をint
として返します。public long longValue()
Byte
の拡張プリミティブ変換後の値をlong
として返します。public float floatValue()
Byte
の拡張プリミティブ変換後の値をfloat
として返します。floatValue
、クラスNumber
float
型に変換した値。public double doubleValue()
Byte
の拡張プリミティブ変換後の値をdouble
として返します。doubleValue
、クラスNumber
double
型に変換した値。public String toString()
Byte
の値を表すString
オブジェクトを返します。 値は、符号付きの10進数表現に変換され、文字列として返されます。これは、byte
値がtoString(byte)
メソッドの引数として指定された場合とまったく同じです。 public int hashCode()
Byte
のハッシュ・コード(intValue()
を呼び出した場合の結果と等しくなる)を返します。hashCode
、クラスObject
Byte
のハッシュ・コード値Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public static int hashCode(byte value)
Byte.hashCode()
との互換性がある、byte
値のハッシュ・コードを返します。value
- ハッシュ対象の値byte
値のハッシュ・コード値。public boolean equals(Object obj)
true
になるのは、引数がnull
ではなく、このオブジェクトと同じbyte
値を含むByte
オブジェクトである場合だけです。 equals
、クラスObject
obj
- 比較対象のオブジェクトtrue
、そうでない場合はfalse
。Object.hashCode()
、HashMap
public int compareTo(Byte anotherByte)
Byte
オブジェクトを数値的に比較します。compareTo
、インタフェースComparable<Byte>
anotherByte
- 比較対象のByte
。Byte
が引数Byte
と等しい場合は値0
、このByte
が引数Byte
より小さい数値の場合は0
より小さい値、このByte
が引数Byte
より大きい数値の場合は0
より大きい値(符号付きの比較)。public static int compare(byte x, byte y)
byte
値を数値的に比較します。 返される値は、次から返される値と同じになります。
Byte.valueOf(x).compareTo(Byte.valueOf(y))
x
- 比較する最初のbyte
y
- 比較する2番目のbyte
x == y
の場合は値0
、x < y
の場合は0
より小さい値、x> y
の場合は0
より大きい値public static int toUnsignedInt(byte x)
int
に変換します。 int
への符号なし変換では、int
の上位24ビットがゼロになり、下位8ビットがbyte
引数のビットに等しくなります。 その結果、ゼロと正のbyte
値が数値的に等しいint
値にマップされ、負のbyte
値が入力に28を加算した値に等しいint
値にマップされます。 x
- 符号なしint
に変換する値int
に変換された引数public static long toUnsignedLong(byte x)
long
に変換します。 long
への符号なし変換では、long
の上位56ビットがゼロになり、下位8ビットがbyte
引数のビットに等しくなります。 その結果、ゼロと正のbyte
値が数値的に等しいlong
値にマップされ、負のbyte
値が入力に28を加算した値に等しいlong
値にマップされます。 x
- 符号なしlong
に変換する値long
に変換された引数 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。