Float.ValueOf 方法

[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

參數

傳回

Float表示的f實例。

屬性

RegisterAttribute

備註

傳 Float 回實例，表示指定的 float 值。 如果不需要新的 Float 實例，則此方法通常應該用於建構函 #Float(float)式的喜好設定，因為此方法可能會藉由快取經常要求的值來產生較佳的空間和時間效能。

已在1.5中新增。

的 java.lang.Float.valueOf(float)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

[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

參數

傳回

Float物件，保留自變數所String表示的值。

屬性

RegisterAttribute

例外狀況

備註

Float傳回物件，其包含float自變數字串 s所表示的值。

如果 s 為 null，則會 NullPointerException 擲回 。

中的 s 前置和尾端空格符會被忽略。 空格符會如同由 String#trim 方法移除;也就是說，會移除 ASCII 空格符和控制字元。 其餘的 s 應該構成 FloatValue ，如語匯語法規則所述：

<blockquote><dl><dt>FloatValue：<dd>Sign sub>opt/sub<>NaN>dd Sign<<<> sub opt</subInfinity><dd>><Sign sub opt</sub> FloatingPointLiteral dd>Sign<>sub opt</sub> HexFloatingPointLiteral<<dd>SignedInteger</dl>

<dl><dt>HexFloatingPointLiteral： <dd>HexSignificand BinaryExponent FloatTypeSuffix_opt</dl>

<dl><dt>HexSignificand：<dd>HexNumeral dd>HexNumeral.<<dd0x>HexDigits<sub>opt</sub HexDigits dd0X> HexDigits<sub>opt</sub.>.> HexDigits<</dl>

<dl><dt>BinaryExponent：<dd>BinaryExponentIndicator SignedInteger</dl>

<dl><dt>BinaryExponentIndicator：<ddp<>dd>P</dl>

</blockquote>

其中 Sign、FloatingPointLiteral、HexNumeral、HexDigits、SignedInteger 和 FloatTypeSuffix，如引用>Java 語言規格</引用>的<語匯結構區段所定義，但數字之間不接受底線。 如果沒有 s FloatValue 的形式，則會NumberFormatException擲回 。 否則， s 會被視為代表一般「計算機化科學表示法」或確切十六進位值中的精確十進位值;然後，這個確切的數值會概念上轉換成「無限精確」二進位值，然後由 IEEE 754 浮點算術的一般四捨五入到最接近的型 float 別，其中包括保留零值的正負號。

請注意，四捨五入到最接近的規則也意味著溢位和下溢行為：如果 的確切值大小夠大（大於或等於 （#MAX_VALUEMath#ulp(float) ulp(MAX_VALUE) + /2），四捨五入float將會產生無限大，如果 的確切值ss小到大小（小於或等於 #MIN_VALUE/2），四捨五入為浮點將會產生零。

最後，在四捨五入 Float 代表此值 float 的 物件之後，會傳回 。

若要解譯浮點值的當地語系化字串表示，請使用的 java.text.NumberFormat子類別。

請注意，尾端格式規範、決定浮點常值類型的規範（1.0f是值;1.0d為doublefloat值），請勿><</em> 影響此方法的結果。 換句話說，輸入字串的數值會直接轉換成目標浮點類型。 一般而言，轉換的雙步驟序列字串 double 後面接著 double 為 float，是 <em>not</em> ，相當於將字串直接 float轉換成 。 例如，如果先轉換成中繼，然後再轉換成 ，則字串<br 會產生<"1.00000017881393421514957253748434595763683319091796875001d"float>> 值1.0000002f;如果字串直接float轉換成 ，1.000000<b>1</b>f則會產生結果。floatdouble

為了避免在無效的字串上呼叫這個方法並 NumberFormatException 擲回 ，檔會 Double#valueOf Double.valueOf 列出可用來篩選輸入的正則表達式。

的 java.lang.Float.valueOf(java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

另請參閱

• ParseFloat(String)