Float.ValueOf メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| ValueOf(Single) |
指定した値を |
| ValueOf(String) |
|
ValueOf(Single)
指定した値を Float 表すインスタンスを返します float 。
[Android.Runtime.Register("valueOf", "(F)Ljava/lang/Float;", "")]
public static Java.Lang.Float ValueOf (float f);[<Android.Runtime.Register("valueOf", "(F)Ljava/lang/Float;", "")>]
static member ValueOf : single -> Java.Lang.Floatパラメーター
- f
- Single
float 値。
戻り値
を Float 表す fインスタンス。
- 属性
注釈
指定した値を Float 表すインスタンスを返します float 。 新 Float しいインスタンスが必要ない場合は、通常、このメソッドをコンストラクター #Float(float)より優先して使用する必要があります。このメソッドは、頻繁に要求される値をキャッシュすることで、大幅に優れたスペースと時間のパフォーマンスを得る可能性が高くなります。
1\.5 で追加されました。
の Java ドキュメント java.lang.Float.valueOf(float)。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
ValueOf(String)
Float引数文字列 sで表される値をfloat保持する オブジェクトを返します。
[Android.Runtime.Register("valueOf", "(Ljava/lang/String;)Ljava/lang/Float;", "")]
public static Java.Lang.Float ValueOf (string s);[<Android.Runtime.Register("valueOf", "(Ljava/lang/String;)Ljava/lang/Float;", "")>]
static member ValueOf : string -> Java.Lang.Floatパラメーター
- s
- String
解析する文字列。
戻り値
引数でFloatString表される値を保持する オブジェクト。
- 属性
例外
を float 値として解析できない場合 string は 。
注釈
Float引数文字列 sで表される値をfloat保持する オブジェクトを返します。
が の場合sは、 NullPointerException がスローnullされます。
の s 先頭と末尾の空白文字は無視されます。 メソッドのように空白文字が削除されます String#trim 。つまり、ASCII スペースと制御文字の両方が削除されます。 の残りの部分 s は、字句構文規則で説明されているように FloatValue を 構成する必要があります。
<blockquote><dl><dt>FloatValue:<dd>Sign<sub>opt</sub>NaN<dd>Sign<sub>opt</sub>Infinity<dd>Sign<sub>opt</sub> FloatingPointLiteral<dd>Sign<sub>opt</sub> HexFloatingPointLiteral<dd>SignedInteger</dl>
<dl><dt>HexFloatingPointLiteral: <dd>HexSignificand BinaryExponent FloatTypeSuffix<sub>opt</sub></dl>
<dl><dt>HexSignificand:<dd>HexNumeral<dd>HexNumeral.<ddHexDigits<sub>opt</sub>. HexDigits<dd>0X HexDigits<sub>opt</sub>.HexDigits</dl>0x>
<dl><dt>BinaryExponent:<dd>BinaryExponentIndicator SignedInteger</dl>
<dl><dt>BinaryExponentIndicator:<dd>p<dd>P</dl>
</blockquote>
ここで、Sign、FloatingPointLiteral、HexNumeral、HexDigits、SignedInteger、FloatTypeSuffix は、cite>の字句構造セクション<で定義されているとおりです。ただし、数字<>間でアンダースコアを使用することはできません。 FloatValue の形式がない場合sは、 NumberFormatException がスローされます。 それ以外の場合は、 s 通常の "コンピューター化された科学的表記" または正確な 16 進数の値で正確な 10 進値を表すものと見なされます。この正確な数値は、概念的には "無限に正確な" バイナリ値に変換され、その後、通常の IEEE 754 浮動小数点算術の最も近い規則 (ゼロ値の符号の保持を含む) によって型 float に丸められます。
最も近いラウンドツーニアスルールはオーバーフローとアンダーフローの動作も意味します。の正確な値sの大きさが十分な大きさ (/ + Math#ulp(float) ulp(MAX_VALUE)#MAX_VALUE2 以上) の場合、 にfloat丸めると無限大が発生し、 のs正確な値が大きさが十分に小さい (/2 以下) 場合、float に#MIN_VALUE丸めると 0 になります。
最後に、このfloat値を表すオブジェクトをFloat丸めた後に が返されます。
浮動小数点値のローカライズされた文字列表現を解釈するには、 の java.text.NumberFormatサブクラスを使用します。
末尾の書式指定子、浮動小数点リテラルの型を決定する指定子 (1.0f は値です。1.0d値) はdouble、このメソッドの結果に影響を><与えます<>。float つまり、入力文字列の数値は、ターゲット浮動小数点型に直接変換されます。 一般に、変換の 2 段階のシーケンスである string から にdouble続く double は、<文字列を floatに直接float変換することと同等の em>not</em> です。 たとえば、最初に中間doubleに変換してから にfloat変換した場合、文字列<br"1.00000017881393421514957253748434595763683319091796875001d"<>br> は値1.0000002fになりますfloat。文字列が に直接float1.000000<b>1</b>f変換される場合は、結果が返されます。
無効な文字列 NumberFormatException でこのメソッドを呼び出して をスローしないようにするために、 の Double#valueOf Double.valueOf ドキュメントには、入力のスクリーニングに使用できる正規表現が一覧表示されています。
の Java ドキュメント java.lang.Float.valueOf(java.lang.String)。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。