java.lang.Object

java.lang.Number

java.lang.Float

すべての実装されたインタフェース:: Serializable, Comparable<Float>, Constable, ConstantDesc

public final class Float extends Number implements Comparable<Float>, Constable, ConstantDesc

Floatクラスは、プリミティブ型floatの値をオブジェクトにラップします。 Float型のオブジェクトには、型がfloatの単一フィールドが含まれます。

さらにこのクラスは、floatをStringに、Stringをfloatに変換する各種メソッドや、floatの処理時に役立つ定数およびメソッドも提供します。

これはvalue-basedクラスです。プログラマは、equalのインスタンスを交換可能として扱い、同期にインスタンスを使用しないようにする必要があります。そうしないと、予期しない動作が発生する可能性があります。たとえば、将来のリリースでは、同期が失敗する可能性があります。

浮動小数点等価、等価および比較

クラスjava.lang.Doubleには、float値に等しく適用可能な「等価性、等価性、浮動小数点値の比較の説明」があります。

導入されたバージョン:

1.0

関連項目:

フィールドのサマリー

フィールド

修飾子と型

フィールド

説明

static final int

BYTES

float値を表すために使用されるバイト数です。

static final int

MAX_EXPONENT

有限のfloat変数が持つ可能性のある最大指数です。

static final float

MAX_VALUE

float型の正の最大有限値(2-2^-23)·2¹²⁷です。

static final int

MIN_EXPONENT

正規化されたfloat変数が持つ可能性のある最小指数です。

static final float

MIN_NORMAL

float型の正の最小標準値2^-126を保持する定数です。

static final float

MIN_VALUE

float型の正の最小非ゼロ値2^-149を保持する定数です。

static final float

NaN

float型の非数(NaN)値を保持する定数です。

static final float

NEGATIVE_INFINITY

float型の負の無限大値を保持する定数です。

static final float

POSITIVE_INFINITY

float型の正の無限大値を保持する定数です。

static final int

PRECISION

float値の仮数のビット数。

static final int

SIZE

float値を表すのに使われるビット数です。

static final Class<Float>

TYPE

プリミティブ型floatを表すClassインスタンス。
コンストラクタのサマリー

コンストラクタ

コンストラクタ

説明

Float(double value)

非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
このコンストラクタを使用することはほとんどありません。

Float(float value)

非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
このコンストラクタを使用することはほとんどありません。

Float(String s)

非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
このコンストラクタを使用することはほとんどありません。
メソッドのサマリー

修飾子と型

メソッド

説明

byte

byteValue()

このFloatの縮小プリミティブ変換後の値をbyteとして返します。

static int

compare(float f1, float f2)

指定された2つのfloat値を比較します。

int

compareTo(Float anotherFloat)

2つのFloatオブジェクトを数値的に比較します。

Optional<Float>

describeConstable()

このインスタンス自体の名目記述子を含むOptionalを返します。

double

doubleValue()

このFloatの拡張プリミティブ変換後の値をdoubleとして返します。

boolean

equals(Object obj)

このオブジェクトと指定されたオブジェクトを比較します。

static float

float16ToFloat(short floatBinary16)

引数の数値に最も近いfloat値を、shortでエンコードされた浮動小数点binary16値を返します。

static short

floatToFloat16(float f)

引数に最も近い shortでエンコードされた浮動小数点binary16値を返します。

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値を返します。

Float

resolveConstantDesc(MethodHandles.Lookup lookup)

このインスタンスをConstantDescとして解決します。その結果がインスタンス自体です。

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オブジェクトを返します。

クラスjava.lang.Objectで宣言されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

フィールド詳細
- 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)·2¹²⁷です。 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)とも同等です。
  関連項目:
  
  定数フィールド値
- SIZE
  
  public static final int SIZE
  
  float値を表すのに使われるビット数です。
  導入されたバージョン:
  
  1.5
  
  関連項目:
  
  定数フィールド値
- PRECISION
  
  public static final int PRECISION
  
  float値の仮数のビット数。これは、「Java言語仕様」のセクション4.2.3のパラメータNです。
  導入されたバージョン:
  
  19
  
  関連項目:
  
  定数フィールド値
- 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
  
  関連項目:
  
  定数フィールド値
- BYTES
  
  public static final int BYTES
  
  float値を表すために使用されるバイト数です。
  導入されたバージョン:
  
  1.8
  
  関連項目:
  
  定数フィールド値
- TYPE
  
  public static final Class<Float> TYPE
  
  プリミティブ型floatを表すClassインスタンス。
  
  導入されたバージョン:
  
  1.1
コンストラクタの詳細
- Float
  
  @Deprecated(since="9", forRemoval=true) public Float(float value)
  
  非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
  このコンストラクタを使用することはほとんどありません。静的ファクトリvalueOf(float)は、より良いスペースと時間のパフォーマンスをもたらす可能性が高いため、通常はより良い選択です。
  
  プリミティブのfloat引数を表す、新しく割り当てられたFloatオブジェクトを構築します。
  
  パラメータ:
  
  value - Floatによって表される値。
- Float
  
  @Deprecated(since="9", forRemoval=true) public Float(double value)
  
  非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
  このコンストラクタを使用することはほとんどありません。代わりに、静的ファクトリ・メソッドvalueOf(float)メソッドを次のように使用: Float.valueOf((float)value)。
  
  float型に変換された引数を表す、新しく割り当てられたFloatオブジェクトを構築します。
  
  パラメータ:
  
  value - Floatによって表される値。
- Float
  
  @Deprecated(since="9", forRemoval=true) public Float(String s) throws NumberFormatException
  
  非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
  このコンストラクタを使用することはほとんどありません。文字列を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は正で有限です。次の2つの段階で文字列に変換されます:
    
    小数点以下の選択: mを表すために、適切に定義された小数点d_mが選択されています。この小数点は、IEEE 754浮動小数点演算の最も近い端数処理ポリシーに従ってmに四捨五入される(ほとんど)です。
    文字列としての書式設定: 10進数のd_mは、値に応じてプレーンまたはコンピュータ化された科学表記で文字列として書式設定されます。
「小数」は、sが10の倍数でないように、一部の(一意)整数s > 0およびiに対するs×10ⁱという形式の数です。これらの整数は、それぞれ小数の「仮数」および「指数」です。小数点のlengthは、10^n-1 ≤ s < 10ⁿに一致する(一意)正の整数nです。
有限正のmの小数d_mは次のように定義されます:
- IEEE 754浮動小数点演算の通常の「四捨五入」丸めポリシーに従って、Rをmに丸めるすべての小数点のセットにします。
- pは、Rのすべての小数点以下の最小長にします。
- p≥2の場合、Tを長さpのR内のすべての小数点のセットにします。それ以外の場合は、Tを長さ1または2のR内のすべての小数点のセットにします。
- d_mを、mに最も近いTの小数として定義します。または、Tにこのような小数が2つある場合は、偶数の仮数を持つ小数を選択します。
選択した(独自)の小数点d_mが書式設定されます。 s、iおよびnをそれぞれd_mの仮数、指数および長さとします。さらに、e = n + iとします - s₁…s_nをsの通常の10進展開にします。 s₁≠0およびs_n≠0に注意してください。下の小数点'.'は'\u002E'で、指数インジケータ'E'は'\u0045'です。
- ケース -3 ≤ e < 0: d_mは、0.0…0としてフォーマットされますs₁…s_n。小数点とs₁の間に正確に -(n + i)ゼロがあります。たとえば、123×10^-4は0.0123とフォーマットされます。
- ケース0 ≤ e < 7:
  - サブケースi ≥0: d_mは、s₁…s_nとしてフォーマットされます0…0.0。s_nと小数点の間に正確にiゼロがあります。たとえば、123×10²は12300.0とフォーマットされます。
  - サブケースi < 0: d_mは、s₁…としてフォーマットされますs_n+i.s_n+i+1…s_n、ここで小数点の右に正確に-i桁あります。たとえば、123×10^-1は12.3とフォーマットされます。
- ケースe < -3またはe ≥7: コンピュータ化された科学表記法を使用して、d_mをフォーマットします。ここで、eはInteger.toString(int)によってフォーマットされます。
  - サブケースn = 1: d_mは、s₁ .0Eeとしてフォーマットされます。たとえば、1×10²³は1.0E23とフォーマットされます。
  - サブケースn > 1: d_mは、s₁. s₂としてフォーマットされます…s_nEe。たとえば、123×10^-21は1.23E-19とフォーマットされます。
浮動小数点値のローカライズされた文字列表現を作成する場合、NumberFormatのサブクラスを使用します。
パラメータ:

f - 変換するfloat。

戻り値:

この引数の文字列表現。

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つ以上存在する必要があることに留意してください。

例
浮動小数点値	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

valueOf

public static Float valueOf(String s) throws NumberFormatException

文字列引数sで表されるfloat値を保持するFloatオブジェクトを返します。
sがnullの場合、NullPointerExceptionがスローされます。
s内の先頭と末尾の空白文字は無視されます。空白文字は、String.trim()メソッドで削除されるときのように削除されます。つまり、ASCIIの空白文字と制御文字の両方が削除されます。 sの残りの文字が、次の字句構文ルールに従ってFloatValueを構成します。

FloatValue:
Sign_opt NaN
Sign_opt Infinity
Sign_opt FloatingPointLiteral
Sign_opt HexFloatingPointLiteral
SignedInteger

HexFloatingPointLiteral:
HexSignificand BinaryExponent FloatTypeSuffix_opt

HexSignificand:
HexNumeral
HexNumeral .
0x HexDigits_opt . HexDigits
0X HexDigits_opt . HexDigits

BinaryExponent:
BinaryExponentIndicator SignedInteger

BinaryExponentIndicator:
p
P

ここで、Sign、FloatingPointLiteral、HexNumeral、HexDigits、SignedInteger、およびFloatTypeSuffixは、「Java言語仕様」の字句構造セクションで定義されていますが、これらの桁間のアンダースコアは受け入れられません。 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を返します。

APIのノート:

このメソッドは、IEEE 754で定義されているisNaN演算に対応します。

パラメータ:

v - 判定される値。

戻り値:

引数がNaNである場合はtrue、そうでない場合はfalse。
isInfinite

public static boolean isInfinite(float v)

指定された数値の絶対値が無限量である場合にはtrueを、そうでない場合にはfalseを返します。

APIのノート:

このメソッドは、IEEE 754で定義されているisInfinite演算に対応します。

パラメータ:

v - 判定される値。

戻り値:

引数が正または負の無限大の場合はtrue、そうでない場合はfalse。
isFinite

public static boolean isFinite(float f)

引数が有限の浮動小数点値である場合はtrueを返し、そうでない場合(NaNおよび無限大の引数の場合)はfalseを返します。

APIのノート:

このメソッドは、IEEE 754で定義されているisFinite演算に対応します。

パラメータ:

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として返します。

オーバーライド:

byteValue、クラスNumber

戻り値:

このオブジェクトが表すfloat値をbyte型に変換したもの。

Java言語仕様を参照してください:

5.1.3 プリミティブ・コンバージョンの解説
shortValue

public short shortValue()

このFloatの縮小プリミティブ変換後の値をshortとして返します。

オーバーライド:

shortValue、クラスNumber

戻り値:

このオブジェクトが表すfloat値をshort型に変換したもの。

Java言語仕様を参照してください:

5.1.3 プリミティブ・コンバージョンの解説

導入されたバージョン:

1.1
intValue

public int intValue()

このFloatの縮小プリミティブ変換後の値をintとして返します。

定義:

intValue、クラスNumber

戻り値:

このオブジェクトが表すfloat値をint型に変換したもの。

Java言語仕様を参照してください:

5.1.3 プリミティブ・コンバージョンの解説
longValue

public long longValue()

このFloatの縮小プリミティブ変換後の値をlongとして返します。

定義:

longValue、クラスNumber

戻り値:

このオブジェクトが表すfloat値をlong型に変換したもの。

Java言語仕様を参照してください:

5.1.3 プリミティブ・コンバージョンの解説
floatValue

public float floatValue()

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

定義:

floatValue、クラスNumber

戻り値:

このオブジェクトが表すfloat値。
doubleValue

public double doubleValue()

このFloatの拡張プリミティブ変換後の値をdoubleとして返します。

定義:

doubleValue、クラスNumber

APIのノート:

このメソッドは、IEEE 754で定義されているconvertFormat演算に対応します。

戻り値:

このオブジェクトが表す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値が返される場合だけです。
オーバーライド:

equals、クラスObject

APIのノート:

このメソッドは、==演算子が等価関係を定義せず、「等しい契約」を満たすために等価関係を実装する必要があるため、float値の==演算子ではなくfloatToIntBits(float)という観点で定義されます。浮動小数点の等価性と等価性の詳細は、「このディスカッション」を参照してください。

パラメータ:

obj -比較対象のオブジェクト。

戻り値:

オブジェクトが同じである場合はtrue、そうでない場合はfalse。

Java言語仕様を参照してください:

「15.21.1 数値等価演算子==と!=」

関連項目:
- 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つの値について次の引数から計算できるとします。
```
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の値と等しくなります。
このメソッドは、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浮動小数点値。
float16ToFloat

public static float float16ToFloat(short floatBinary16)
引数の数値に最も近いfloat値を、shortでエンコードされた浮動小数点binary16値を返します。変換は正確です。すべてのbinary16値は、floatで正確に表すことができます。特例として:
- 引数がゼロの場合、結果は引数と同じ符号を持つゼロになります。
- 引数が無限の場合、結果は引数と同じ符号を持つ無限大になります。
- 引数がNaNの場合、結果はNaNになります。
IEEE 754 binary16形式
IEEE 754標準では、binary16を16ビット形式、32ビットのbinary32形式( float型に対応)および64ビットのbinary64形式(double型に対応)として定義しています。 binary16形式は、ほかのIEEE 754形式に似ていますが、小さい形式の場合は、NaN、署名されたインフィニティ、符号付きゼロ、サブ・ノーマルなどの通常のIEEE 754値がすべて含まれています。 binary16書式のパラメータ(JLS 4.2.3)は、N = 11精度ビット、K = 5指数ビット、E_「最高」 = 15,およびE_「分」 = -14です。
APIのノート:

このメソッドは、IEEE 754で定義されたconvertFormat操作にbinary16形式からbinary32形式に対応します。このメソッドの操作は、プリミティブ拡張変換 (JLS 5.1.2)に似ています。

パラメータ:

floatBinary16 - floatに変換するbinary16値

戻り値:

引数の数値に最も近いfloat値、shortでエンコードされた浮動小数点binary16値

導入されたバージョン:

20
floatToFloat16

public static short floatToFloat16(float f)
引数に最も近い shortでエンコードされた浮動小数点binary16値を返します。変換は「最も近い偶数丸めモードへの丸め」で計算されます。特例として:
- 引数がゼロの場合、結果は引数と同じ符号を持つゼロになります。
- 引数が無限の場合、結果は引数と同じ符号を持つ無限大になります。
- 引数がNaNの場合、結果はNaNになります。
「binary16形式」の詳細は、float16ToFloat(short)メソッドを参照してください。
APIのノート:

このメソッドは、IEEE 754で定義されたconvertFormat操作にbinary32形式からbinary16形式に対応します。このメソッドの操作は、プリミティブ・ナローイング変換(JLS 5.1.3)に似ています。

パラメータ:

f - binary16に変換するfloat値

戻り値:

shortでエンコードされた浮動小数点のbinary16値(引数に最も近い値)

導入されたバージョン:

20
compareTo

public int compareTo(Float anotherFloat)
2つのFloatオブジェクトを数値的に比較します。このメソッドでは、float値のJava言語数値比較演算子(<, <=, ==, >=, >)で定義された不完全な順序と比較して、2つの差異があるFloatオブジェクトに合計順序が適用されます。
- NaNは、他の値に関して「順序なし」で、比較演算子ではそれ自体に対して不等です。このメソッドは、 Float.NaNをそれ自体に等しく、他のすべてのdouble値( Float.POSITIVE_INFINITYを含む)より大きく定義することを選択します。
- 正のゼロと負のゼロは、数値で比較されますが、区別できる値は明確です。このメソッドでは、正のゼロ((+0.0f))を負のゼロ((-0.0f))より大きい値として定義します。
これにより、このメソッドによって課されるFloatオブジェクトの「自然順序付け」が「等しい」であることが保証されます。浮動小数点比較および順序付けの詳細は、「このディスカッション」を参照してください。
定義:

compareTo、インタフェースComparable<Float>

パラメータ:

anotherFloat - 比較対象のFloat。

戻り値:

anotherFloatがこのFloatと同じ数値の場合は値0。FloatがanotherFloatより小さい数値の場合は0より小さい値。FloatがanotherFloatより大きい数値の場合は0より大きい値。

Java言語仕様を参照してください:

「15.20.1 数値比較演算子<、<=、>および>=」

導入されたバージョン:

1.2
compare

public static int compare(float f1, float f2)
指定された2つのfloat値を比較します。返される整数値の符号は、次の呼出しで返される整数の符号と同じになります。
```
    Float.valueOf(f1).compareTo(Float.valueOf(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値を加算します。
APIのノート:

このメソッドは、IEEE 754で定義されている追加演算に対応します。

パラメータ:

a - 第1オペランド

b - 第2オペランド

戻り値:

aとbの合計

Java言語仕様を参照してください:

4.2.4 浮動小数点操作

導入されたバージョン:

1.8

関連項目:
- BinaryOperator
max

public static float max(float a, float b)

Math.maxを呼び出した場合と同様に、2つのfloat値の大きいほうを返します。
APIのノート:

このメソッドは、IEEE 754で定義されている最大演算数に対応します。

パラメータ:

a - 第1オペランド

b - 第2オペランド

戻り値:

aとbのどちらか大きい方

導入されたバージョン:

1.8

関連項目:
- BinaryOperator
min

public static float min(float a, float b)

Math.minを呼び出した場合と同様に、2つのfloat値の小さいほうを返します。
APIのノート:

このメソッドは、IEEE 754で定義されている最小動作に対応します。

パラメータ:

a - 第1オペランド

b - 第2オペランド

戻り値:

aとbのどちらか小さい方

導入されたバージョン:

1.8

関連項目:
- BinaryOperator
describeConstable

public Optional<Float> describeConstable()

このインスタンス自体の名目記述子を含むOptionalを返します。

定義:

インタフェースConstable内のdescribeConstable

戻り値:

Floatインスタンスを説明するOptional

導入されたバージョン:

12
resolveConstantDesc

public Float resolveConstantDesc(MethodHandles.Lookup lookup)

このインスタンスをConstantDescとして解決します。その結果がインスタンス自体です。

定義:

インタフェースConstantDesc内のresolveConstantDesc

パラメータ:

lookup - ignored

戻り値:

Floatインスタンス

導入されたバージョン:

12

クラスFloat

浮動小数点等価、等価および比較

フィールドのサマリー

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

メソッドのサマリー

クラスjava.lang.Objectで宣言されたメソッド

フィールド詳細

POSITIVE_INFINITY

NEGATIVE_INFINITY

NaN

MAX_VALUE

MIN_NORMAL

MIN_VALUE

SIZE

PRECISION

MAX_EXPONENT

MIN_EXPONENT

BYTES

TYPE

コンストラクタの詳細

Float

Float

Float

メソッドの詳細

toString

toHexString

valueOf

valueOf

parseFloat

isNaN

isInfinite

isFinite

isNaN

isInfinite

toString

byteValue

shortValue

intValue

longValue

floatValue

doubleValue

hashCode

hashCode

equals

floatToIntBits

floatToRawIntBits

intBitsToFloat

float16ToFloat

IEEE 754 binary16形式

floatToFloat16

compareTo

compare

sum

max

min

describeConstable

resolveConstantDesc