java.lang
クラス Integer

java.lang.Object
  java.lang.Integer

public final class Integer
extends Object

プリミティブ型の int をラップするクラスです。 Integer オブジェクトは一つの int 型の値を保持します。

ラップを行う他に String クラスへの変換および String クラスからの変換等の int に関連する処理を提供します。

MIN_VALUE

public static final int MIN_VALUE

int が表現できる下限値 (-2147483648) を示します。

MAX_VALUE

public static final int MAX_VALUE

int が表現できる最大値 (2147483647) を示します。

Integer

public Integer(int value)

パラメータに渡された value を持つオブジェクトを生成します。

パラメータ:

value - ラップする対象の整数値を渡します。

toString

public static String toString(int value,
                              int radix)

渡された整数 value を、基数を radix とした文字列表現を作成して返します。

基数として指定された radix が Character.MIN_RADIX から Character.MAX_RADIX の範囲外の場合は、基数は 10 として処理が行われます。

変換対象の整数 value がマイナス値である場合、文字列の先頭にはマイナスであることを示す記号“-”(\u002d) が付加されます。 プラス値の場合には何も付加されません。

文字列への変換は、表現するのに必要な最小桁数で表現が行われます。先頭に“0”(\u0030 が付加されることはありません。

基数が 10 を超える場合、アルファベットが用いられます。使用される文字は、“0123456789abcdefghijklmnopqrstuvwxyz”となります。 つまり、9 の次は a、その次は b というように使用する文字を決定します。

例えば radix が 16、value が 255 の場合、返す文字列は ff となります。

パラメータ:

value - 変換する対象の整数を渡します。

radix - 変換する際の基数を渡します。

戻り値:

変換した結果の文字列を返します。

toHexString

public static String toHexString(int value)

渡された整数の 16 進数の文字列表現を作成して返します。

引数が負数の場合、MSB( 最上位ビット =0x80000000l を加算した数 ) を立てた数として 16 進数文字列を作成します。 文字列の先頭にマイナスは付加しません。

文字列への変換は、表現するのに必要な最小桁数で表現が行われます。先頭に“0”(\u0030 が付加されることはありません。

16 進数表現では 10 以上の数を表す際にアルファベットを使用します。使用する文字は、“0123456789abcdef”の 16 文字です。 9 の次は a、その次は b というように使用する文字を決定します。

パラメータ:

value - 変換する対象の整数を渡します。

戻り値:

変換した結果の文字列を返します。

toOctalString

public static String toOctalString(int value)

渡された整数の 8 進数の文字列表現を作成して返します。

引数が負数の場合、MSB( 最上位ビット =0x80000000l を加算した数 ) を立てた数として 8 進数文字列を作成します。 文字列の先頭にマイナスは付加しません。

文字列への変換は、表現するのに必要な最小桁数で表現が行われます。先頭に“0”(\u0030 が付加されることはありません。

8 進数表現では、“01234567”の 8 文字を使用します。

パラメータ:

value - 変換する対象の整数を渡します。

戻り値:

変換した結果の文字列を返します。

toBinaryString

public static String toBinaryString(int value)

渡された整数の 2 進数の文字列表現を作成して返します。

引数が負数の場合、MSB( 最上位ビット =0x80000000l を加算した数 ) を立てた数として 2 進数文字列を作成し、文字列の先頭にマイナスは付加しません。

文字列への変換は、表現するのに必要な最小桁数で表現が行われます。先頭に“0”(\u0030) が付加されることはありません。

2 進数表現では、0 と 1 の 2 文字のみを使用します。

パラメータ:

value - 変換する対象の整数を渡します。

戻り値:

変換した結果の文字列を返します。

toString

public static String toString(int value)

渡された整数の 10 進数の文字列表現を作成して返します。 これは基数を 10 として toString(int, int) を呼び出すのと等価です。

パラメータ:

value - 返還する対象の整数を渡します。

戻り値:

変換した結果の文字列を返します。

parseInt

public static int parseInt(String target,
                           int radix)
                    throws NumberFormatException

渡された文字列 target を、基数 radix の数値として評価し、その結果を int 型の値として返します。 文字列に含まれる文字は全て基数 radix で数値に評価可能な文字でなければなりません。 数値へ評価できるかどうかは Character.isDigit(char) メソッドで判定することができます。 なお、文字列の先頭には符号を表すマイナス“-”(\u002d) の存在が許されます。

文字列を int 型の数値として評価できない場合には NumberFormatException が throw されます。 評価に失敗する条件は以下の通りです。

• 渡された文字列 target に基数 radix では使用できない文字が含まれている場合。
• 渡された基数 radix が Character.MIN_RADIX から Character.MAX_RADIX の範囲外である場合。
• target が null である場合。
• 評価結果が int 型で表現できる数値の範囲を超えた場合。

パラメータ:

target - 評価する対象の文字列を渡します。

radix - 評価する際の基数を渡します。

戻り値:

評価した結果の整数を返します。

例外:

NumberFormatException - 渡された文字列を渡された基数で整数に評価できなかった場合に throw します。

parseInt

public static int parseInt(String target)
                    throws NumberFormatException

渡された文字列 target を 10 進数表現の int 値として評価し、その結果を返します。 このメソッドの呼び出しは基数に 10 を指定して parseInt(String, int) メソッドを呼び出すのと等価です。

パラメータ:

target - 評価する対象の文字列を渡します。

戻り値:

評価した結果の整数を返します。

例外:

NumberFormatException - 渡された文字列を 10 進数として整数に評価できなかった場合に throw します。

valueOf

public static Integer valueOf(String target,
                              int radix)
                       throws NumberFormatException

渡された文字列 target を、基数 radix の数値として評価し、その結果を保持した Integer オブジェクトを返します。

このメソッドの処理結果は、

     new Integer(Integer.parseInt(target, radix));

と記述するのと等価です。

パラメータ:

target - 評価する対象の文字列を渡します。

radix - 評価する際の基数を渡します。

戻り値:

評価した結果の整数を保持した Integer オブジェクトを返します。

例外:

NumberFormatException - 渡された文字列を 10 進数として整数に評価できなかった場合に throw します。

valueOf

public static Integer valueOf(String target)
                       throws NumberFormatException

渡された文字列 target を 10 進数表現の int 値として評価し、その結果を保持した Integer オブジェクトを返します。

このメソッドの処理結果は、

     new Integer(Integer.parseInt(target));

と記述するのと等価です。

パラメータ:

target - 評価する対象の文字列を渡します。

戻り値:

評価した結果の整数を保持した Integer オブジェクトを返します。

例外:

NumberFormatException - 渡された文字列を 10 進数として整数に評価できなかった場合に throw します。

byteValue

public byte byteValue()

オブジェクトが保持している int 値を byte 値として返します。

戻り値:

オブジェクトが保持している int 値を byte 値としたのものを返します。

shortValue

public short shortValue()

オブジェクトが保持している int 値を short 値として返します。

戻り値:

オブジェクトが保持している int 値を short 値としたのものを返します。

intValue

public int intValue()

オブジェクトが保持している int 値を返します。

戻り値:

オブジェクトが保持している int 値を返します。

longValue

public long longValue()

オブジェクトが保持している int 値を long 値として返します。

戻り値:

オブジェクトが保持している int 値を long 値とへキャストしたのものを返します。

toString

public String toString()

オブジェクトが保持している int 値を 10 進数表現の文字列を持った String オブジェクトへ変換します。

このメソッドの処理結果は、toString(int) メソッドの引数に intValue() メソッドの戻り値を渡して呼び出すように記述するのと等価です。

オーバーライド:

クラス Object 内の toString

戻り値:

オブジェクトが保持している int 値を文字列として表現した結果を返します。

hashCode

public int hashCode()

オブジェクトのハッシュコードを返します。

オーバーライド:

クラス Object 内の hashCode

戻り値:

対応するハッシュコード。

equals

public boolean equals(Object obj)

渡されたオブジェクトとオブジェクトを比較します。 パラメータ obj に渡されたオブジェクトが Integer クラスでなおかつ同じ int 値を保持している場合に true を、そうでない場合は false を返します。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象のオブジェクトを渡します。

戻り値:

等しい場合は true を、等しくない場合は false を返します。