java.lang
クラス Long

java.lang.Object
  java.lang.Long

public final class Long
extends Object

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

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

MIN_VALUE

public static final long MIN_VALUE

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

MAX_VALUE

public static final long MAX_VALUE

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

Long

public Long(long value)

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

パラメータ:

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

toString

public static String toString(long 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 - 変換する対象の long 型の整数を渡します。

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

戻り値:

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

toString

public static String toString(long value)

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

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

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

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

パラメータ:

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

戻り値:

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

parseLong

public static long parseLong(String target,
                             int radix)
                      throws NumberFormatException

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

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

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

パラメータ:

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

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

戻り値:

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

例外:

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

parseLong

public static long parseLong(String target)
                      throws NumberFormatException

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

パラメータ:

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

戻り値:

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

例外:

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

longValue

public long longValue()

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

戻り値:

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

toString

public String toString()

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

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

オーバーライド:

クラス Object 内の toString

戻り値:

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

hashCode

public int hashCode()

オブジェクトのハッシュコードを返します。 ハッシュコードはオブジェクトが保持している long 値の上位 32 ビットと下位 32 ビットを排他的論理和演算した結果と等しくなります。

オーバーライド:

クラス Object 内の hashCode

戻り値:

対応するハッシュコードを返します。

equals

public boolean equals(Object obj)

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

オーバーライド:

クラス Object 内の equals

パラメータ:

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

戻り値:

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