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 的 f实例。
- 属性
注解
返回表示 Float 指定 float 值的实例。 如果不需要新 Float 实例，则通常应优先使用此方法，而不是构造函数 #Float(float)，因为此方法通过缓存频繁请求的值可能会产生明显更好的空间和时间性能。
在 1.5 中添加。
的 java.lang.Float.valueOf(float)Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
适用于
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 对象， 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</sub>Infinity<dd>Sign<sub>opt</sub> FloatingPointLiteral<dd>Sign<sub>opt</sub> HexFloatingPointLiteral<dd>SignedInteger</dl>
<dl><dt>HexFloatingPointLiteral： <ddHexSignificand BinaryExponent FloatTypeSuffix<sub>opt</sub></dl>>
<dl><dt>HexSignificand：<dd>HexNumeral<dd>HexNumeral.<dd>0xHexDigits<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 语言规范</引用>的<词法结构部分中定义，但数字之间不接受下划线。 如果没有 sFloatValue 的形式，则会 NumberFormatException 引发 。 否则， s 被视为表示通常的“计算机化科学表示法”中的精确十进制值，或表示精确的十六进制值;然后，从概念上将这个确切的数值转换为“无限精确”二进制值，然后由 IEEE 754 浮点算术的常见圆到最近规则舍入为类型 float ，其中包括保留零值的符号。
请注意，从圆到最接近的规则也意味着溢出和下溢行为：如果 的s确切值在数量级上足够大 (大于或等于 ( + Math#ulp(float) ulp(MAX_VALUE)#MAX_VALUE /2) ，舍入到 float 将导致无穷大，如果 的s确切值在数量级 (小于或等于 #MIN_VALUE/2) ，舍入到浮点数将导致零。
最后，在 Float 舍入后返回表示此值 float 的 对象。
若要解释浮点值的本地化字符串表示形式，请使用 的 java.text.NumberFormat子类。
请注意，尾随格式说明符、确定浮点文本类型的说明符 (1.0f 是值;1.0d是double值) ，不要<><>影响此方法的结果。float 换句话说，输入字符串的数值直接转换为目标浮点类型。 通常，两步转换序列（字符串到 double 后跟double到 float），与<<>>将字符串直接float转换为 并不等效。 例如，如果首先转换为中间double值，然后转换为 float，则字符串<br"1.00000017881393421514957253748434595763683319091796875001d"><将>生成float值1.0000002f;如果字符串直接float转换为 ，1.000000<b>1</b>f则结果。
为了避免对无效字符串调用此方法并 NumberFormatException 引发 ，文档 列出了 Double#valueOf Double.valueOf 可用于筛选输入的正则表达式。
的 java.lang.Float.valueOf(java.lang.String)Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。