Byte (Java Platform SE 8)

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の処理時に役立つ定数およびメソッドも提供します。

導入されたバージョン:

JDK1.1

関連項目:

Number, 直列化された形式

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`BYTES` 2の補数バイナリ形式で`byte`値を表すために使用されるバイト数。
`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`オブジェクトを構築します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`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`オブジェクトを返します。

クラス 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
    
    関連項目:
    
    定数フィールド値
  - BYTES
```
public static final int BYTES
```
    2の補数バイナリ形式でbyte値を表すために使用されるバイト数。
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - 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,
                             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を含まない場合。
  - 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:
    Sign_opt DecimalNumeral
    Sign_opt 0x HexDigits
    Sign_opt 0X HexDigits
    Sign_opt # HexDigits
    Sign_opt 0 OctalDigits
    Sign:
    -
    +
    
    DecimalNumeral、HexDigits、およびOctalDigitsは、『Java(tm)言語仕様』のセクション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として返します。
    
    オーバーライド:
    
    byteValue、クラス: Number
    
    戻り値:
    
    このオブジェクトが表す数値をbyte型に変換した値。
  - shortValue
```
public short shortValue()
```
    このByteの拡張プリミティブ変換後の値をshortとして返します。
    
    オーバーライド:
    
    shortValue、クラス: Number
    
    戻り値:
    
    このオブジェクトが表す数値をshort型に変換した値。
    
    『Java(tm)言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - intValue
```
public int intValue()
```
    このByteの拡張プリミティブ変換後の値をintとして返します。
    
    定義:
    
    intValue、クラス: Number
    
    戻り値:
    
    このオブジェクトが表す数値をint型に変換した値。
    
    『Java(tm)言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - longValue
```
public long longValue()
```
    このByteの拡張プリミティブ変換後の値をlongとして返します。
    
    定義:
    
    longValue、クラス: Number
    
    戻り値:
    
    このオブジェクトが表す数値をlong型に変換した値。
    
    『Java(tm)言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - floatValue
```
public float floatValue()
```
    このByteの拡張プリミティブ変換後の値をfloatとして返します。
    
    定義:
    
    floatValue、クラス: Number
    
    戻り値:
    
    このオブジェクトが表す数値をfloat型に変換した値。
    
    『Java(tm)言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - doubleValue
```
public double doubleValue()
```
    このByteの拡張プリミティブ変換後の値をdoubleとして返します。
    
    定義:
    
    doubleValue、クラス: Number
    
    戻り値:
    
    このオブジェクトが表す数値をdouble型に変換した値。
    
    『Java(tm)言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - toString
```
public String toString()
```
    このByteの値を表すStringオブジェクトを返します。値は、符号付きの10進数表現に変換され、文字列として返されます。これは、byte値がtoString(byte)メソッドの引数として指定された場合とまったく同じです。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    
    このオブジェクトの10進数(基数10)による文字列表現。
  - 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
  - toUnsignedInt
```
public static int toUnsignedInt(byte x)
```
    符号なし変換によって、その引数をintに変換します。intへの符号なし変換では、intの上位24ビットがゼロになり、下位8ビットがbyte引数のビットに等しくなります。その結果、ゼロと正のbyte値が数値的に等しいint値にマップされ、負のbyte値が入力に2⁸を加算した値に等しいint値にマップされます。
    
    パラメータ:
    
    x - 符号なしintに変換する値
    
    戻り値:
    
    符号なし変換によってintに変換された引数
    
    導入されたバージョン:
    
    1.8
  - toUnsignedLong
```
public static long toUnsignedLong(byte x)
```
    符号なし変換によって、その引数をlongに変換します。longへの符号なし変換では、longの上位56ビットがゼロになり、下位8ビットがbyte引数のビットに等しくなります。その結果、ゼロと正のbyte値が数値的に等しいlong値にマップされ、負のbyte値が入力に2⁸を加算した値に等しいlong値にマップされます。
    
    パラメータ:
    
    x - 符号なしlongに変換する値
    
    戻り値:
    
    符号なし変換によってlongに変換された引数
    
    導入されたバージョン:
    
    1.8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスByte

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

MIN_VALUE

MAX_VALUE

TYPE

SIZE

BYTES

コンストラクタの詳細

Byte

Byte

メソッドの詳細

toString

valueOf

parseByte

parseByte

valueOf

valueOf

decode

byteValue

shortValue

intValue

longValue

floatValue

doubleValue

toString

hashCode

hashCode

equals

compareTo

compare

toUnsignedInt

toUnsignedLong