- java.lang.Object
-
- java.lang.Number
-
- java.lang.Float
-
- すべての実装されたインタフェース:
Serializable
,Comparable<Float>
public final class Float extends Number implements Comparable<Float>
Float
クラスは、プリミティブ型float
の値をオブジェクトにラップします。Float
型のオブジェクトには、型がfloat
の単一フィールドが含まれます。さらにこのクラスは、
float
をString
に、String
をfloat
に変換する各種メソッドや、float
の処理時に役立つ定数およびメソッドも提供します。- 導入されたバージョン:
- 1.0
- 関連項目:
- 直列化された形式
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static int
BYTES
float
値を表すために使用されるバイト数です。static int
MAX_EXPONENT
有限のfloat
変数が持つ可能性のある最大指数です。static float
MAX_VALUE
float
型の正の最大有限値(2-2-23)·2127です。static int
MIN_EXPONENT
正規化されたfloat
変数が持つ可能性のある最小指数です。static float
MIN_NORMAL
float
型の正の最小標準値2-126を保持する定数です。static float
MIN_VALUE
float
型の正の最小非ゼロ値2-149を保持する定数です。static float
NaN
float
型の非数(NaN)値を保持する定数です。static float
NEGATIVE_INFINITY
float
型の負の無限大値を保持する定数です。static float
POSITIVE_INFINITY
float
型の正の無限大値を保持する定数です。static int
SIZE
float
値を表すのに使われるビット数です。static Class<Float>
TYPE
プリミティブ型float
を表すClass
インスタンス。
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 byte
byteValue()
このFloat
の縮小プリミティブ変換後の値をbyte
として返します。static int
compare(float f1, float f2)
指定された2つのfloat
値を比較します。int
compareTo(Float anotherFloat)
2つのFloat
オブジェクトを数値的に比較します。double
doubleValue()
このFloat
の拡張プリミティブ変換後の値をdouble
として返します。boolean
equals(Object obj)
このオブジェクトと指定されたオブジェクトを比較します。static int
floatToIntBits(float value)
IEEE 754浮動小数点の「シングル・フォーマット」ビット・レイアウトに従って、指定された浮動小数点の値を表現して返します。static int
floatToRawIntBits(float value)
IEEE 754浮動小数点の「シングル・フォーマット」ビット・レイアウトに従って、非数(NaN)値を保持する、指定された浮動小数点値の表現を返します。float
floatValue()
このFloat
オブジェクトのfloat
値を返します。int
hashCode()
このFloat
オブジェクトのハッシュ・コードを返します。static int
hashCode(float value)
Float.hashCode()
との互換性がある、float
値のハッシュ・コードを返します。static float
intBitsToFloat(int bits)
指定されたビット表現と対応するfloat
値を返します。int
intValue()
このFloat
の縮小プリミティブ変換後の値をint
として返します。static boolean
isFinite(float f)
引数が有限の浮動小数点値である場合はtrue
を返し、そうでない場合(NaNおよび無限大の引数の場合)はfalse
を返します。boolean
isInfinite()
このFloat
値の絶対値が無限量である場合にはtrue
を、そうでない場合にはfalse
を返します。static boolean
isInfinite(float v)
指定された数値の絶対値が無限量である場合にはtrue
を、そうでない場合にはfalse
を返します。boolean
isNaN()
このFloat
値が非数(NaN)である場合にはtrue
を、そうでない場合はfalse
を返します。static boolean
isNaN(float v)
指定された数値が非数(NaN)である場合にはtrue
を、そうでない場合はfalse
を返します。long
longValue()
このFloat
の縮小プリミティブ変換後の値をlong
として返します。static float
max(float a, float b)
Math.max
を呼び出した場合と同様に、2つのfloat
値の大きいほうを返します。static float
min(float a, float b)
Math.min
を呼び出した場合と同様に、2つのfloat
値の小さいほうを返します。static float
parseFloat(String s)
Float
クラスのvalueOf
メソッドを実行した場合と同様に、指定されたString
が表す値に初期化された新しいfloat
値を返します。short
shortValue()
このFloat
の縮小プリミティブ変換後の値をshort
として返します。static float
sum(float a, float b)
+演算子のように、2つのfloat
値を加算します。static String
toHexString(float f)
float
引数の16進数文字列表現を返します。String
toString()
このFloat
オブジェクトの文字列表現を返します。static String
toString(float f)
float
引数の文字列表現を返します。static Float
valueOf(float f)
指定されたfloat
値を表すFloat
インスタンスを返します。static Float
valueOf(String s)
文字列引数s
で表されるfloat
値を保持するFloat
オブジェクトを返します。
-
-
-
フィールドの詳細
-
POSITIVE_INFINITY
public static final float POSITIVE_INFINITY
float
型の正の無限大値を保持する定数です。 これは、Float.intBitsToFloat(0x7f800000)
から返される値と等しくなります。- 関連項目:
- 定数フィールド値
-
NEGATIVE_INFINITY
public static final float NEGATIVE_INFINITY
float
型の負の無限大値を保持する定数です。 これは、Float.intBitsToFloat(0xff800000)
から返される値と等しくなります。- 関連項目:
- 定数フィールド値
-
NaN
public static final float NaN
float
型の非数(NaN)値を保持する定数です。 これは、Float.intBitsToFloat(0x7fc00000)
から返される値と等しくなります。- 関連項目:
- 定数フィールド値
-
MAX_VALUE
public static final float MAX_VALUE
float
型の正の最大有限値(2-2-23)·2127です。 16進数浮動小数点リテラル0x1.fffffeP+127f
と同等であり、Float.intBitsToFloat(0x7f7fffff)
とも同等です。- 関連項目:
- 定数フィールド値
-
MIN_NORMAL
public static final float MIN_NORMAL
float
型の正の最小標準値2-126を保持する定数です。 16進数浮動小数点リテラル0x1.0p-126f
と同等であり、Float.intBitsToFloat(0x00800000)
とも同等です。- 導入されたバージョン:
- 1.6
- 関連項目:
- 定数フィールド値
-
MIN_VALUE
public static final float MIN_VALUE
float
型の正の最小非ゼロ値2-149を保持する定数です。 16進数浮動小数点リテラル0x0.000002P-126f
と同等であり、Float.intBitsToFloat(0x1)
とも同等です。- 関連項目:
- 定数フィールド値
-
MAX_EXPONENT
public static final int MAX_EXPONENT
有限のfloat
変数が持つ可能性のある最大指数です。 これは、Math.getExponent(Float.MAX_VALUE)
から返される値と等しくなります。- 導入されたバージョン:
- 1.6
- 関連項目:
- 定数フィールド値
-
MIN_EXPONENT
public static final int MIN_EXPONENT
正規化されたfloat
変数が持つ可能性のある最小指数です。 これは、Math.getExponent(Float.MIN_NORMAL)
から返される値と等しくなります。- 導入されたバージョン:
- 1.6
- 関連項目:
- 定数フィールド値
-
SIZE
public static final int SIZE
float
値を表すのに使われるビット数です。- 導入されたバージョン:
- 1.5
- 関連項目:
- 定数フィールド値
-
BYTES
public static final int BYTES
float
値を表すために使用されるバイト数です。- 導入されたバージョン:
- 1.8
- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
Float
@Deprecated(since="9") public Float(float value)
非推奨。このコンストラクタを使用することはほとんどありません。 静的ファクトリvalueOf(float)
は、より良いスペースと時間のパフォーマンスをもたらす可能性が高いため、通常はより良い選択です。プリミティブのfloat
引数を表す、新しく割り当てられたFloat
オブジェクトを構築します。- パラメータ:
value
-Float
によって表される値。
-
Float
@Deprecated(since="9") public Float(double value)
非推奨。このコンストラクタを使用することはほとんどありません。 代わりに、静的ファクトリ・メソッドvalueOf(float)
メソッドを次のように使用:Float.valueOf((float)value)
。float
型に変換された引数を表す、新しく割り当てられたFloat
オブジェクトを構築します。- パラメータ:
value
-Float
によって表される値。
-
Float
@Deprecated(since="9") public Float(String s) throws NumberFormatException
非推奨。このコンストラクタを使用することはほとんどありません。 文字列をfloat
プリミティブに変換するにはparseFloat(String)
を使用し、文字列をFloat
オブジェクトに変換するにはvalueOf(String)
を使用します。文字列で表されるfloat
型の浮動小数点を表す、新しく割り当てられるFloat
オブジェクトを構築します。 文字列は、valueOf
メソッドと同様にfloat
値に変換されます。- パラメータ:
s
-Float
に変換する文字列。- 例外:
NumberFormatException
- 文字列が解析可能な数値を含まない場合。
-
-
メソッドの詳細
-
toString
public static String toString(float f)
float
引数の文字列表現を返します。 次の文字はすべてASCII文字です。- 引数がNaNの場合、変換後の文字列は「
NaN
」。 - そうでない場合、結果は、引数の符号および絶対値を表す文字列になります。 符号が負の場合、結果の文字列の最初の文字は「
-
」('\u002D'
)となり、符号が正の場合、結果の文字列に符号文字は表示されない。 絶対値mについては、次のとおり:- mが無限大の場合、これは文字列
"Infinity"
で表される。したがって、正の無限大の結果は"Infinity"
、負の無限大の結果は"-Infinity"
となる。 - mがゼロの場合、これは文字列
"0.0"
で表される。したがって、負のゼロの結果は"-0.0"
、正のゼロの結果は"0.0"
となる。 - mが10-3以上107未満の場合、これは、mの整数部(先行するゼロを付けない10進数の形式)、「
.
」('\u002E'
)、mの小数部を表す1桁以上の10進数、を順に並べたもので表現される。 - mが10-3未満、あるいは107以上の場合は、浮動小数点表示形式で表現される。 nを、10n ≤m < 10n+1を満たす一意の整数とし、aを、mと10nの数学的に正確な商(1 ≤a < 10)とする。 このとき、絶対値は、aの整数部を表す1桁の10進数、「
.
」('\u002E'
)、aの小数部を表す何桁かの10進数、文字「E
」('\u0045'
)、nを10進整数として表現したもの(メソッドInteger.toString(int)
で生成)、を順に並べたもので表現される。
- mが無限大の場合、これは文字列
float
型の隣接する値から引数を一意に識別するのに最低限必要な桁数にしてください。 たとえば、ゼロでない有限の引数fを指定してこのメソッドで作成した10進値表記をxとします。 この場合、fはxにもっとも近いfloat
値でなければいけませんが、xまでの距離が同一のfloat
値が2つ存在する場合には、fはそのどちらかであり、かつfの仮数の最下位ビットが0
でなければいけません。浮動小数点値のローカライズされた文字列表現を作成する場合、
NumberFormat
のサブクラスを使用します。- パラメータ:
f
- 変換対象のfloat。- 戻り値:
- この引数の文字列表現。
- 引数がNaNの場合、変換後の文字列は「
-
toHexString
public static String toHexString(float f)
float
引数の16進数文字列表現を返します。 次の文字はすべてASCII文字です。- 引数がNaNの場合、変換後の文字列は「
NaN
」。 - そうでない場合、結果は、引数の符号および絶対値を表す文字列になります。 符号が負の場合、結果の文字列の最初の文字は「
-
」('\u002D'
)となり、符号が正の場合、結果の文字列に符号文字は表示されない。 絶対値mについては、次のとおり:- mが無限大の場合、これは文字列
"Infinity"
で表される。したがって、正の無限大の結果は"Infinity"
、負の無限大の結果は"-Infinity"
となる。 - mがゼロの場合、これは文字列
"0x0.0p0"
で表される。したがって、負のゼロの結果は"-0x0.0p0"
、正のゼロの結果は"0x0.0p0"
となる。 - mが正規化された表現の
float
値の場合は、有効数字と指数のフィールドを表すのに部分文字列が使われる。 有効数字は、文字列"0x1."
と、小数部として残りの有効数字の小文字の16進表現を続けて表される。 すべての桁が0でないかぎり(すべてが0の場合は単一の0を使用)、16進表現の末尾の0は削除される。 次に、指数は、指数値でInteger.toString
を呼び出して生成するときのように、"p"
とそれに続く完全な指数の10進数文字列で表される。 - mが非正規表現の
float
値の場合、有効数字は、文字列"0x0."
と、小数部として残りの有効数字の16進表現を続けて表される。 16進表現の末尾の0は削除されます。 次に、指数は"p-126"
で表される。 サブノーマル有効数字内に、ゼロでない数字が1つ以上存在する必要があることに留意してください。
- mが無限大の場合、これは文字列
例 浮動小数点値 16進数文字列 1.0
0x1.0p0
-1.0
-0x1.0p0
2.0
0x1.0p1
3.0
0x1.8p1
0.5
0x1.0p-1
0.25
0x1.0p-2
Float.MAX_VALUE
0x1.fffffep127
Minimum Normal Value
0x1.0p-126
Maximum Subnormal Value
0x0.fffffep-126
Float.MIN_VALUE
0x0.000002p-126
- パラメータ:
f
- 変換するfloat
。- 戻り値:
- この引数の16進数の文字列表現。
- 導入されたバージョン:
- 1.5
- 引数がNaNの場合、変換後の文字列は「
-
valueOf
public static Float valueOf(String s) throws NumberFormatException
文字列引数s
で表されるfloat
値を保持するFloat
オブジェクトを返します。s
がnull
の場合、NullPointerException
がスローされます。s
内の先頭と末尾の空白文字は無視されます。 空白文字は、String.trim()
メソッドで削除されるときのように削除されます。つまり、ASCIIの空白文字と制御文字の両方が削除されます。s
の残りの文字が、次の字句構文ルールに従ってFloatValueを構成します。- FloatValue:
- Signopt
NaN
- Signopt
Infinity
- Signopt FloatingPointLiteral
- Signopt HexFloatingPointLiteral
- SignedInteger
- Signopt
- HexFloatingPointLiteral:
- HexSignificand BinaryExponent FloatTypeSuffixopt
- HexSignificand:
- HexNumeral
- HexNumeral
.
0x
HexDigitsopt.
HexDigits0X
HexDigitsopt.
HexDigits - HexNumeral
- BinaryExponent:
- BinaryExponentIndicator SignedInteger
- BinaryExponentIndicator:
p
P
s
の形式がFloatValueでない場合は、NumberFormatException
がスローされます。 そうでない場合、s
は通常の「浮動小数点表記」、つまり正確な10進値または16進値を表していると見なされます。この正確な数値は、概念上は「無限に正確なバイナリ値」に変換されてから、IEEE 754浮動小数点計算法による通常の最近似値丸め法(ゼロ値の符号保持を含む)に従ってfloat
型に丸められます。 最近似値丸め法は、オーバーフローやアンダーフローの動作が発生することも意味します。s
の正確な値の絶対値が十分大きい場合(MAX_VALUE
+ulp(MAX_VALUE)
/2以上の場合)、float
に丸めると無限大になり、s
の正確な値が十分小さい場合(MIN_VALUE
/2以下の場合)、float に丸めるとゼロになることに注意してください。 最後に、丸めが完了したら、このfloat
値を表すFloat
オブジェクトが返されます。浮動小数点値のローカライズされた文字列表現を解釈する場合、
NumberFormat
のサブクラスを使用します。末尾の形式指定子つまり浮動小数点リテラルの種類を決定する指定子(
1.0f
はfloat
値、1.0d
はdouble
値)は、このメソッドの結果に与えません。 つまり、入力文字列の数値は、ターゲットの浮動小数点型に直接変換されます。 一般に、文字列をdouble
に変換し、double
をfloat
に変換する2ステップのシーケンスは、文字列をfloat
に変換するのと等価ではありません。 たとえば、文字列
"1.00000017881393421514957253748434595763683319091796875001d"
を最初に中間のdouble
に変換し、次にfloat
に変換した場合、結果はfloat
値1.0000002f
になります。その文字列をfloat
に直接変換した場合、結果は1.0000001f
になります。無効な文字列でこのメソッドが呼び出されたり、
NumberFormatException
がスローされたりしないようにするために、Double.valueOf
のマニュアルには、入力のスクリーニングに使うことができる正規表現が記載されています。- パラメータ:
s
- 解析される文字列。- 戻り値:
String
引数により表される値を保持するFloat
オブジェクト。- 例外:
NumberFormatException
- 文字列が解析可能な数値を含まない場合。
-
valueOf
public static Float valueOf(float f)
指定されたfloat
値を表すFloat
インスタンスを返します。 新規Float
インスタンスが不要な場合、通常このメソッドがコンストラクタFloat(float)
に優先して使用されます。その理由は、このメソッドが頻繁に要求される値をキャッシュするので、操作に必要な領域や時間がはるかに少なくて済む場合が多いためです。- パラメータ:
f
- float値。- 戻り値:
f
を表すFloat
インスタンス。- 導入されたバージョン:
- 1.5
-
parseFloat
public static float parseFloat(String s) throws NumberFormatException
Float
クラスのvalueOf
メソッドを実行した場合と同様に、指定されたString
が表す値に初期化された新しいfloat
値を返します。- パラメータ:
s
- 解析される文字列。- 戻り値:
- 文字列引数で表される
float
値。 - 例外:
NullPointerException
- 文字列がnullの場合NumberFormatException
- 文字列が解析可能なfloat
を含まない場合。- 導入されたバージョン:
- 1.2
- 関連項目:
valueOf(String)
-
isNaN
public static boolean isNaN(float v)
指定された数値が非数(NaN)である場合にはtrue
を、そうでない場合はfalse
を返します。- パラメータ:
v
- 判定される値。- 戻り値:
- 引数がNaNである場合は
true
、そうでない場合はfalse
。
-
isInfinite
public static boolean isInfinite(float v)
指定された数値の絶対値が無限量である場合にはtrue
を、そうでない場合にはfalse
を返します。- パラメータ:
v
- 判定される値。- 戻り値:
- 引数が正または負の無限大の場合は
true
、そうでない場合はfalse
。
-
isFinite
public static boolean isFinite(float f)
引数が有限の浮動小数点値である場合はtrue
を返し、そうでない場合(NaNおよび無限大の引数の場合)はfalse
を返します。- パラメータ:
f
- 判定されるfloat
値- 戻り値:
- その引数が有限の浮動小数点値である場合は
true
、それ以外の場合はfalse
- 導入されたバージョン:
- 1.8
-
isNaN
public boolean isNaN()
このFloat
値が非数(NaN)である場合にはtrue
を、そうでない場合はfalse
を返します。- 戻り値:
- このオブジェクトが表す値がNaNである場合は
true
、そうでない場合はfalse
。
-
isInfinite
public boolean isInfinite()
このFloat
値の絶対値が無限量である場合にはtrue
を、そうでない場合にはfalse
を返します。- 戻り値:
- このオブジェクトが表す値が正の無限大または負の無限大である場合は
true
、そうでない場合はfalse
。
-
toString
public String toString()
このFloat
オブジェクトの文字列表現を返します。 このオブジェクトが表すプリミティブfloat
値は、1つの引数を取るtoString
メソッドを実行した場合と同じString
に変換されます。- オーバーライド:
toString
、クラスObject
- 戻り値:
- このオブジェクトの
String
表現。 - 関連項目:
toString(float)
-
byteValue
public byte byteValue()
このFloat
の縮小プリミティブ変換後の値をbyte
として返します。
-
shortValue
public short shortValue()
このFloat
の縮小プリミティブ変換後の値をshort
として返します。- オーバーライド:
shortValue
、クラスNumber
- 戻り値:
- このオブジェクトが表す
float
値をshort
型に変換したもの。 - 導入されたバージョン:
- 1.1
- Java™言語仕様を参照します:
- 5.1.3 縮小プリミティブ変換
-
intValue
public int intValue()
このFloat
の縮小プリミティブ変換後の値をint
として返します。
-
longValue
public long longValue()
このFloat
の縮小プリミティブ変換後の値をlong
として返します。
-
floatValue
public float floatValue()
このFloat
オブジェクトのfloat
値を返します。- 定義:
floatValue
、クラスNumber
- 戻り値:
- このオブジェクトが表す
float
値。
-
doubleValue
public double doubleValue()
このFloat
の拡張プリミティブ変換後の値をdouble
として返します。- 定義:
doubleValue
、クラスNumber
- 戻り値:
- このオブジェクトが表す
float
値をdouble
型に変換したもの - Java™言語仕様を参照します:
- 5.1.2 拡張プリミティブ変換
-
hashCode
public int hashCode()
このFloat
オブジェクトのハッシュ・コードを返します。 結果は、floatToIntBits(float)
メソッドで生成した場合とまったく同じように、このFloat
オブジェクトが表すプリミティブfloat
値のint型ビット表現になります。- オーバーライド:
hashCode
、クラスObject
- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
hashCode
public static int hashCode(float value)
Float.hashCode()
との互換性がある、float
値のハッシュ・コードを返します。- パラメータ:
value
- ハッシュ対象の値- 戻り値:
float
値のハッシュ・コード値。- 導入されたバージョン:
- 1.8
-
equals
public boolean equals(Object obj)
このオブジェクトと指定されたオブジェクトを比較します。 結果がtrue
になるのは、引数がnull
でなく、このオブジェクトが表すfloat
値と同じ値のfloat
を表すFloat
オブジェクトである場合だけです。 このため、2つのfloat
値が等しいと見なされるのは、floatToIntBits(float)
メソッドを各値に適用したときに同一のint
値が返される場合だけです。ほとんどの場合、クラス
Float
の2つのインスタンスf1
とf2
について、f1.equals(f2)
の値がtrue
になるのは、f1.floatValue() == f2.floatValue()
上記の値も
true
になる場合だけです。 しかし、例外事項も2つあります。f1
とf2
がどちらもFloat.NaN
を表している場合、Float.NaN==Float.NaN
の値がfalse
になるにもかかわらず、equals
メソッドからはtrue
が返されます。f1
が+0.0f
を表し、f2
が-0.0f
を表している場合、あるいはその逆の場合、0.0f==-0.0f
の値がtrue
になるにもかかわらず、equal
テストの値はfalse
になります。
- オーバーライド:
equals
、クラスObject
- パラメータ:
obj
-比較対象のオブジェクト。- 戻り値:
- オブジェクトが同じである場合は
true
、そうでない場合はfalse
。 - 関連項目:
floatToIntBits(float)
-
floatToIntBits
public static int floatToIntBits(float value)
IEEE 754浮動小数点の「シングル・フォーマット」ビット・レイアウトに従って、指定された浮動小数点の値を表現して返します。ビット31 (マスク
0x80000000
によって選択されるビット)は、浮動小数点の符号を表します。 ビット30-23 (マスク0x7f800000
によって選択されるビット)は、指数を表します。 ビット22-0 (マスク0x007fffff
によって選択されるビット)は、浮動小数点の有効値(仮数と呼ばれる場合もある)を表します。引数が正の無限大の場合、結果は
0x7f800000
になります。引数が負の無限大の場合、結果は
0xff800000
になります。引数がNaNの場合、結果は
0x7fc00000
になります。どの場合も、返される値は整数であり、
intBitsToFloat(int)
メソッドを指定すると、floatToIntBits
への引数と同じ浮動小数点値になります(すべてのNaN値が単一の「正規」NaN値に収納されることを除く)。- パラメータ:
value
- 浮動小数点値。- 戻り値:
- 浮動小数点値を表すビット。
-
floatToRawIntBits
public static int floatToRawIntBits(float value)
IEEE 754浮動小数点の「シングル・フォーマット」ビット・レイアウトに従って、非数(NaN)値を保持する、指定された浮動小数点値の表現を返します。ビット31 (マスク
0x80000000
によって選択されるビット)は、浮動小数点の符号を表します。 ビット30-23 (マスク0x7f800000
によって選択されるビット)は、指数を表します。 ビット22-0 (マスク0x007fffff
によって選択されるビット)は、浮動小数点の有効値(仮数と呼ばれる場合もある)を表します。引数が正の無限大の場合、結果は
0x7f800000
になります。引数が負の無限大の場合、結果は
0xff800000
になります。引数がNaNの場合、返される値は実際のNaN値を示す整数です。
floatToIntBits
メソッドとは異なり、floatToRawIntBits
メソッドが、すべてのビット・パターン符号化NaNを単一の「正規」NaN値に収納することはありません。どの場合も、返される値は整数であり、
intBitsToFloat(int)
メソッドを指定すると、floatToRawIntBits
への引数と同じ浮動小数点値になります。- パラメータ:
value
- 浮動小数点値。- 戻り値:
- 浮動小数点値を表すビット。
- 導入されたバージョン:
- 1.3
-
intBitsToFloat
public static float intBitsToFloat(int bits)
指定されたビット表現と対応するfloat
値を返します。 引数は、IEEE 754浮動小数点「シングル・フォーマット(single format)」ビット配列に従った浮動小数点表現と見なされます。引数が
0x7f800000
の場合、結果は正の無限大値になります。引数が
0xff800000
の場合、結果は負の無限大値になります。引数が
0x7f800001
から0x7fffffff
、または0xff800001
から0xffffffff
の範囲内の値である場合、結果はNaNになります。 Javaにより提供されるIEEE 754浮動小数点操作は、異なるビット・パターンを持つ同じ型の2つのNaN値を識別できません。 個別のNaN値を識別できるのは、Float.floatToRawIntBits
メソッドを使用する場合だけです。そのほかの場合では、s、e、およびmの3つの値について次の引数から計算できるとします。
この場合、浮動小数点値の結果は、数式s·m·2e-150の値と等しくなります。int s = ((bits >> 31) == 0) ? 1 : -1; int e = ((bits >> 23) & 0xff); int m = (e == 0) ? (bits & 0x7fffff) << 1 : (bits & 0x7fffff) | 0x800000;
このメソッドは、
int
引数とまったく同じビット・パターンを持つfloat
NaNを返すことができない可能性があります。 IEEE 754では、2種類のNaN (「シグナルを発生しないNaN」と「シグナルを発生するNaN」)を区別します。 2種類のNaNの違いは、通常Javaでは確認できません。 シグナルを発生するNaNでの算術演算では、シグナルを発生するNaNが、異種でありながら同様のビット・パターンを持つシグナルを発生しないNaNに変わります。 ただし、シグナルを発生するNaNを単にコピーする一部のプロセッサも、この変換も行います。 特に、シグナルを発生するNaNをコピーして、呼出し側のメソッドに返すことで、この変換を実行できます。 したがって、intBitsToFloat
は、シグナルを発生するNaNビット・パターンを持つfloat
を返すことができない可能性があります。 したがって、一部のint
値では、floatToRawIntBits(intBitsToFloat(start))
がstart
と等しくならないことがあります。 加えて、どの特定のビット・パターンがシグナルを発生するNaNを表すかは、プラットフォームによって異なります。シグナルを発生しないかシグナルを発生するかにかかわらず、すべてのNaNビット・パターンは上に示すNaNの範囲になければいけません。- パラメータ:
bits
- 整数。- 戻り値:
- 同じビット・パターンを持つ
float
浮動小数点値。
-
compareTo
public int compareTo(Float anotherFloat)
2つのFloat
オブジェクトを数値的に比較します。 このメソッドによる比較は、Java言語の数値比較演算子(<,<=,==,>=,>
)をプリミティブfloat
値に適用した場合とは、次の2点で異なります。-
このメソッドでは、
Float.NaN
は自身に等しく、ほかのすべてのfloat
値(Float.POSITIVE_INFINITY
を含む)よりも大きいとみなされる。 -
このメソッドでは、
0.0f
は-0.0f
より大きいとみなされる。
Float
オブジェクトの自然順序付けで、equalsとの一貫性が確保されます。- 定義:
compareTo
、インタフェースComparable<Float>
- パラメータ:
anotherFloat
- 比較対象のFloat
。- 戻り値:
anotherFloat
がこのFloat
と同じ数値の場合は値0
。Float
がanotherFloat
より小さい数値の場合は0
より小さい値。Float
がanotherFloat
より大きい数値の場合は0
より大きい値。- 導入されたバージョン:
- 1.2
- 関連項目:
Comparable.compareTo(Object)
-
このメソッドでは、
-
compare
public static int compare(float f1, float f2)
指定された2つのfloat
値を比較します。 返される整数値の符号は、次の呼出しで返される整数の符号と同じになります。new Float(f1).compareTo(new Float(f2))
- パラメータ:
f1
- 比較する最初のfloat
。f2
- 比較する2番目のfloat
。- 戻り値:
f1
がこのf2
と同じ数値の場合は値0
。f1
がf2
より小さい数値の場合は0
より小さい値。f1
がf2
より大きい数値の場合は0
より大きい値。- 導入されたバージョン:
- 1.4
-
sum
public static float sum(float a, float b)
+演算子のように、2つのfloat
値を加算します。- パラメータ:
a
- 第1オペランドb
- 第2オペランド- 戻り値:
a
とb
の合計- 導入されたバージョン:
- 1.8
- 関連項目:
BinaryOperator
- Java™言語仕様を参照します:
- 4.2.4 浮動小数点操作
-
max
public static float max(float a, float b)
Math.max
を呼び出した場合と同様に、2つのfloat
値の大きいほうを返します。- パラメータ:
a
- 第1オペランドb
- 第2オペランド- 戻り値:
a
とb
のどちらか大きい方- 導入されたバージョン:
- 1.8
- 関連項目:
BinaryOperator
-
min
public static float min(float a, float b)
Math.min
を呼び出した場合と同様に、2つのfloat
値の小さいほうを返します。- パラメータ:
a
- 第1オペランドb
- 第2オペランド- 戻り値:
a
とb
のどちらか小さい方- 導入されたバージョン:
- 1.8
- 関連項目:
BinaryOperator
-
-