Float.ValueOf 方法

[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則拋出 a NullPointerException 。

引出和拖尾的空白字元 s 則被忽略。 空白空間被移除，就像用方法 String#trim 一樣;也就是說，ASCII 空間和控制字元都被移除。 其餘的 s 應該構成詞彙語法規則所描述的 FloatValue ：

<blockquote><dl><dt>FloatValue：<dd>符號_optNaN<dd>簽名<>sub opt</sub>Infinity<dd>簽名_opt 浮點 直文<dd>符號_opt HexFloatingPointLiteral<dd>簽名整數</dl>

<dl><dt>HexFloatingPoint，直文： <dd>HexSignificand BinaryExponent floatTypeSuffix_opt</dl>

<dl><dt>HexSignificand：<dd>HexNumeral<dd>HexNumeral.<dd>0xHexDigits_opt. HexDigits dd HexDigits<<>HexDigits./dl<>

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

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

</區塊引用>

其中符號、浮點字面值、十六進數數、十六進位數字、簽名整數及浮點類型後綴皆如引用Java語言規範</引用>的詞彙結構部分<>所定義，但不允許在數字間加底線。 若 s 不具 floatValue 形式，則拋出 a NumberFormatException 。 否則， s 則被視為在通常的「電腦化科學記號法」中代表精確的十進位值，或是精確的十六進位值;這個精確的數值接著會被概念性地轉換成一個「無限精確」的二進位值，然後再依照 IEEE 754 浮點運算的四捨五入到最近規則將其捨入為型， float 該規則包括保留零值的符號。

請注意，四捨五入到最近規則同時也意味著溢出與下流行為;若 的s精確值大小足夠大（大於或等於 （#MAX_VALUE + Math#ulp(float) ulp(MAX_VALUE)/2），四捨五入float為 會得到無限大;若 的s精確值大小足夠小（小於或等於 #MIN_VALUE/2），則四捨五入為浮點會得到零。

最後，捨五入 Float 後會回傳一個代表該 float 值的物件。

要解讀浮點數值的局部字串表示法，請使用 的 java.text.NumberFormat子類。

請注意，尾隨格式指定符，也就是決定浮點數文字類型（1.0f 為值;float為1.0d值）的指定符，是否double<><會影響此方法的結果。> 換句話說，輸入字串的數值會直接轉換成目標浮點型態。 一般而言，兩步驟的轉換序列，字串 到 doubledouble 再接 到 float，是 <em>not</em> 等價於直接將字串轉換成 float。 例如，若先轉換為中間序列double，再轉換為 float，字串<br>"1.00000017881393421514957253748434595763683319091796875001d"<> 得到 值;float1.0000002f若字串直接轉換為 float，1.000000<b>1</b>f則會得到。

為避免在無效字串上呼叫此方法並拋出 a NumberFormatException ，文件 Double#valueOf Double.valueOf 中列出了一個可用來篩選輸入的正則表達式。

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

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

另請參閱

• ParseFloat(String)

[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 屬性授權中所述的詞彙使用。