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