java.lang
クラス Float

java.lang.Object
  java.lang.Float

public class Float
extends Object

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

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

導入されたバージョン:

CLDC 1.1

POSITIVE_INFINITY

public static final float POSITIVE_INFINITY

float 型の正の無限大値を示す定数です。 この値は 0x7f800000 をビッグ・エンディアンとして IEEE 754 浮動小数点の単精度フォーマット（Single Format）とみなした値と等価です。

関連項目:

定数フィールド値

NEGATIVE_INFINITY

public static final float NEGATIVE_INFINITY

float 型の負の無限大値を示す定数です。 この値は 0xff800000 をビッグ・エンディアンとして IEEE 754 浮動小数点の単精度フォーマット（Single Format）とみなした値と等価です。

関連項目:

定数フィールド値

NaN

public static final float NaN

float 型の非数（NaN）を示す定数です。 この値は 0x7fc00000 をビッグ・エンディアンとして IEEE 754 浮動小数点の単精度フォーマット（Single Format）とみなした値と等価です。

関連項目:

定数フィールド値

MAX_VALUE

public static final float MAX_VALUE

float 型の最も大きな値を示す定数です。 この値は 0x7f7fffff をビッグ・エンディアンとして IEEE 754 浮動小数点の単精度フォーマット（Single Format）とみなした値と等価です。

関連項目:

定数フィールド値

MIN_VALUE

public static final float MIN_VALUE

float 型の最も小さな値を示す定数です。 この値は 0x1 をビッグ・エンディアンとして IEEE 754 浮動小数点の単精度フォーマット（Single Format）とみなした値と等価です。

関連項目:

定数フィールド値

Float

public Float(float value)

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

パラメータ:

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

Float

public Float(double value)

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

パラメータ:

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

toString

public static String toString(float d)

渡された単精度値 value の文字列表現を作成して返します。 以下の文字は全て ASCII 文字です。

• value が非数であれば、結果文字列は"NaN"です。
• そうでなければ、結果は value の符号と絶対値を表現する文字列です。 符号がマイナスであれば、結果の先頭文字は '-' です； 符号がプラスであれば、どのような符号文字も結果に付加しません。
• value の絶対値が無限であれば、それは文字列"Infinity"と表現されます。 したがって、プラスの無限大は結果として"Infinity"となり、マイナスの無限大は結果として"-Infinity"となります。
• value の絶対値がゼロであれば、それは文字列"0.0"と表現されます。 したがって、プラスのゼロは結果として"0.0"となり、マイナスのゼロは結果として"-0.0"となります。
• value の絶対値が 10^-3 以上 10^-7 未満の場合、絶対値の整数部にゼロを付加せずに１０進数表現し、小数点 '.'（Unicode U-002E）を加え、絶対値の小数部を１桁以上の１０進数表現した形で結果文字列を作成します。
• value の絶対値が 10^-3 未満あるいは 10^-7 以上の場合、"コンピュータ科学記法"（整数部が 1 〜 9 に収まるように桁を調整し、残りを小数点以下に表現し、調整した桁数分を文字 'E' に続けて指数部に置く表現）による浮動小数点で表現されます。

後者２つの場合には、小数部として出力する桁数は１桁以上必要です。

パラメータ:

d - 文字列表現する単精度値を渡します。

戻り値:

文字列表現に変換した結果を返します。

valueOf

public static Float valueOf(String s)
                     throws NumberFormatException

指定された文字列によって提供された値に初期化された新しい Float オブジェクトを返します。 浮動小数点値を表すように文字列 s を解釈し、その値を持つ Float オブジェクトを作成して返します。

s が null ならば NullPointerException を throw します。

s に含まれる先頭および終端の空白文字は無視します。 s の残りの部分は語彙規則で説明されるように浮動小数点値を構成すべきです：

浮動小数点値:
符号オプション 浮動小数点リテラル

符号と浮動小数点リテラルは Java 言語仕様のセクション 3.10.2 で定義されています。 浮動小数点値の形式でなければ NumberFormatException を throw します。 そうでなければ、それは通常の"コンピュータ科学記法"に基づく正確な 10 進数値を表現するとみなします。 続いて、この正確な 10 進数値を"無限に正確な"バイナリ値へ概念的に変換し、float 型への丸め込みを IEEE 754 浮動小数点演算の規則に沿って行います。 最後に、float 値を表現する新しい Float クラスのオブジェクトを作成します。

パラメータ:

s - 解析する対象の文字列を渡します。

戻り値:

文字列で指定された値に初期化された Float オブジェクトを新たに作成して返します。

例外:

NumberFormatException - 文字列が解析不可能な数値であるなら throw します。

parseFloat

public static float parseFloat(String s)
                        throws NumberFormatException

指定された文字列の表現を Float クラスの valueOf メソッドと同じように評価し、新しい float 値として返します。

パラメータ:

s - 解析する対象の文字列を渡します。

戻り値:

文字列で指定された float 値を返します。

例外:

NumberFormatException - 文字列が解析不可能な数値であるなら throw します。

関連項目:

valueOf(String)

isNaN

public static boolean isNaN(float v)

指定された値が特別な非数（NaN）値ならば true を返します。

パラメータ:

v - テストする対象の値を渡します。

戻り値:

指定された値が非数（NaN）ならば true を、そうでなければ false を返します。

isInfinite

public static boolean isInfinite(float v)

指定された値の絶対値が無限大ならば true を返します。

パラメータ:

v - テストする対象の値を渡します。

戻り値:

指定された値の絶対値が無限大ならば true を、そうでなければ false を返します。

isNaN

public boolean isNaN()

この Float の値が特別な非数（NaN）ならば true を返します。

戻り値:

このオブジェクト値が非数（NaN）ならば true を、そうでなければ false を返します。

isInfinite

public boolean isInfinite()

この Float の値の絶対値が無限大ならば true を返します。

戻り値:

このオブジェクト値の絶対値が無限大ならば true を、そうでなければ false を返します。

toString

public String toString()

この Float の値の文字列表現を返します。 このオブジェクトによるプリミティブ float 値の表現は、toString メソッドでの変換と同様に文字列へ変換されます。

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現を返します。

関連項目:

toString(float)

byteValue

public byte byteValue()

この Float の byte 値（byte 値へキャストした結果）を返します。

戻り値:

このオブジェクトの byte 値を返します。

shortValue

public short shortValue()

この Float の short 値（short 値へキャストした結果）を返します。

戻り値:

このオブジェクトの short 値を返します。

intValue

public int intValue()

この Float の int 値（int 値へキャストした結果）を返します。

戻り値:

このオブジェクトによって表現される float 値を int 型に変換した結果を返します。

longValue

public int longValue()

この Float の long 値（long 値へキャストした結果）を返します。

戻り値:

このオブジェクトによって表現される float 値を long 型に変換した結果を返します。

floatValue

public float floatValue()

この Float の float 値を返します。

戻り値:

このオブジェクトによって表現される float 値を返します。

doubleValue

public float doubleValue()

この Float の float 値を返します。

戻り値:

このオブジェクトによって表現される float 値を double 型に変換した結果を返します。

hashCode

public int hashCode()

この Float オブジェクトのハッシュコードを返します。 返す値は floatToLongBits(float) メソッドで得られる int 値そのままです。

オーバーライド:

クラス Object 内の hashCode

戻り値:

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

equals

public boolean equals(Object obj)

渡されたオブジェクトとこのオブジェクトを比較します。 等しいとして true を返すのは、obj が null ではなく Float クラスと代入互換性があり、保持している float 値が一致する場合のみです。 つまり、floatToLongBits(float) メソッドが返すビット配列を int 値に変換した結果の値が一致する場合と言い換えることができます。

多くの場合は Float クラスのインスタンスを f1 と f2 とした場合に、f1.equals(f2) が true を返すのは f1.floatValue() == f2.floatValue() の式が true となる場合です。 しかし、f1 と f2 の値が両方とも非数（NaN）である場合は式は成立しませんが、内容が同一であるため true を返します。 また、f1 が +0.0f であり f2 が -0.0f を表すか、f1 が -0.0f であり f2 が +0.0f を表す場合は上記の式は成立しますが、このメソッドは false を返します。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - このオブジェクトと比較するオブジェクトを渡します。

戻り値:

このオブジェクトと指定されたオブジェクトが一致するとみなせる場合には true を、そうでなければ false を返します。

関連項目:

Boolean.hashCode(), Hashtable

floatToLongBits

public static int floatToLongBits(float value)

IEEE 754 浮動小数点の単精度フォーマット（float format）によるビット配列に基づいて、指定された浮動小数点の値を表現したものを返します。

ビット 31（0x80000000 でマスクすることによって選択されるビット）は浮動小数点の符号を表現します。 ビット 30 〜 23（0x7f800000 でマスクすることによって選択されるビット）は指数を表現します。 ビット 22 〜 0（0x007fffff でマスクすることによって選択されるビット）は浮動小数点の仮数を表現します。

value が正の無限大であれば、0x7f800000 を返します。

value が負の無限大であれば、0xff800000 を返します。

value が非数（NaN）であれば、0x7fc00000 を返します。

全ての場合において、返した値は intBitsToFloat(int) メソッドに渡すことで元の浮動小数点による値を得ることができます。

パラメータ:

value - 単精度浮動小数点による値を渡します。

戻り値:

浮動小数点を表現するビットを返します。

intBitsToFloat

public static float intBitsToFloat(int bits)

指定されたビット配列によって表現される単精度浮動小数点値を返します。 bits を IEEE 754 浮動小数点の単精度フォーマット（float format）によるビット配列であるとみなし、その評価結果を値として返します。

bits が 0x7f800000 であれば正の無限大を返します。

bits が 0xff800000 であれば負の無限大を返します。

bits が 0x7f800001 から 0x7fffffff の範囲か 0xff800001 から 0xffffffff の範囲であれば非数（NaN）を返します。

他の全てのケースでは、まず s、e および n を bits から算出します：

 int s = ((bits >> 31) == 0) ? 1 : -1;
 int e = ((bits >> 23) & 0xff);
 int m = (e == 0) ? (bits & 0x7fffff) << 1 :
                    (bits & 0x7fffff) | 0x800000;

そして以上の値を数式表現 s ・ m ・ 2^e-150 に当てはめた値を算出し、浮動小数点値として返します。

パラメータ:

bits - 変換する対象のビット配列を渡します。

戻り値:

ビット配列に対応する単精度の浮動小数点値を返します。