类 java.lang.Float

java.lang.Object
   |
   +----java.lang.Number
           |
           +----java.lang.Float

public final class Float

extends Number

Float 类是基本单精度浮点型数据的对象包装类。 每个 Float型对象包含单一的单精度浮点(float)型数据域。

另外，此类还提供了许多方法，可将 float 型转换为 String 型，和将 String 转换为 float，以及其它的处理 float 时有用的常量和方法。

变量索引

MAX_VALUE

单精度浮点数(float)可取的最大值。

MIN_VALUE

单精度浮点数(float)可取的最小值。

NaN

单精度浮点数(float)可取的一个特殊值(NaN)。

NEGATIVE_INFINITY

单精度浮点数(float)的负无限大。

POSITIVE_INFINITY

单精度浮点数(float)的正无限大。

TYPE

描述基本单精度浮点型的类对象。

构造子索引

Float(double)

构造一 Float 对象，表示给定参数相应的 float 型值。

Float(float)

构造一 Float 对象，表示给定的基本 float 参数。

Float(String)

构造一 Float 对象，表示给定字符串对应的 float 型值。

方法索引

byteValue()

返回当前单精度浮点型对象对应的字节值(转换为一字节)。

doubleValue()

返回当前 Float 对象对应的双精度浮点值。

equals(Object)

比较当前对象和其它对象。

floatToIntBits(float)

返回单精度浮点数的位表示形式。

floatValue()

返回当前 Float 对象对应的浮点值。

hashCode()

返回当前 Float 对象的哈希码。

intBitsToFloat(int)

返回给定位表示的相应的单精度浮点数。

intValue()

返回当前 Float 对象对应的整数(通过转换成一整型)。

isInfinite()

如果当前 Float 对象的值为无限大，则返回 true。

isInfinite(float)

如果指定对象的值为无限大，则返回 true。

isNaN()

如果当前 Float 对象的值为 NaN，则返回 true。

isNaN(float)

如果当前指定对象的值为非数值(NaN)，则返回 true。

longValue()

返回当前 Float 对象对应的长整数(通过转换成一长整型)。

shortValue()

返回当前 Float 对象对应的短整型值(转换为一短整型)。

toString()

返回表示当前 Float 对象的字符串。

toString(float)

返回表示指定浮点数的字符串。

valueOf(String)

返回指定字符串相应的浮点值。

变量

 public static final float POSITIVE_INFINITY

单精度浮点数(float)的正无限大。

 public static final float NEGATIVE_INFINITY

单精度浮点数(float)的负无限大。

 public static final float NaN

单精度浮点数(float)可取的一个特殊值(NaN)。

 public static final float MAX_VALUE

单精度浮点数(float)可取的最大值。

 public static final float MIN_VALUE

单精度浮点数(float)可取的最小值。

 public static final Class TYPE

描述基本单精度浮点型的类对象。

构造子

 public Float(float value)

构造一 Float 对象，表示给定的基本 float 参数。

参数：

value - Float 对象表示的值。

 public Float(double value)

构造一 Float 对象，表示给定参数相应的 float 型值。

参数：

value - Float 对象表示的值。

 public Float(String s) throws NumberFormatException

构造一 Float 对象，表示给定字符串对应的 float 型值。 该方法与 valueOf 方法类似，可以将字符串转换为单精度浮点数。

参数：

s - 转换为 Float 型的字符串。

抛出： NumberFormatException

如果该串不包含一个可分裂的数字。

参见：

valueOf

方法

 public static String toString(float f)

返回表示指定浮点数的字符串。

NaN, NEGATIVE_INFINITY, POSITIVE_INFINITY, -0.0和 +0.0 相应的字符串为 "NaN", "-Infinity", "Infinity", "-0.0" 和 "0.0"。

如果 d 在 10-3 <= |d| <=107 范围内, 那么转换后的串格式为 [-]ddd.ddd。 否则，串格式为 [-]m.ddddE±xx。

一个数字的小数点后总有一最小值。 最小值所要求的数字位，用以区分该参数值和其在 float 型中的相邻值。

参数：

d - 转换的单精度浮点数。

返回值：

参数对应的字符串。

 public static Float valueOf(String s) throws NumberFormatException

返回指定字符串相应的浮点值。

参数：

s - 待分析的字符串。

返回值：

一新创建的 Float 对象，初始化为 String 参数对应的浮点值。

抛出： NumberFormatException

如果该串不包含一个可分裂的数字。

 public static boolean isNaN(float v)

如果当前指定对象的值为非数值(NaN)，则返回 true。

参数：

v - 测试的值。

返回值：

如果参数值为 NaN 则为 true，否则为 false。

 public static boolean isInfinite(float v)

如果指定对象的值为无限大，则返回 true。

参数：

v - 测试的值。

返回值：

如果参数值为正无限大或负无限大则为 true；否则为 false。

 public boolean isNaN()

如果当前 Float 对象的值为 NaN，则返回 true。

返回值：

如果当前对象表示的值为 NaN，则为 true，否则为 false。

 public boolean isInfinite()

如果当前 Float 对象的值为无限大，则返回 true。

返回值：

如果当前对象对应的值为正无限或负无限大，则为 true，否则为 false。

 public String toString()

返回表示当前 Float 对象的字符串。 当前对象表示的基本 float 值转换为一恰当串，同带一参数的 toString 方法类似。

返回值：

表示当前对象的相应 String。

覆盖：

类 Object 中的 toString

参见：

toString

 public byte byteValue()

返回当前单精度浮点型对象对应的字节值(转换为一字节)。

覆盖：

类 Number 中的 byteValue

 public short shortValue()

返回当前 Float 对象对应的短整型值(转换为一短整型)。

覆盖：

类 Number 中的 shortValue

 public int intValue()

返回当前 Float 对象对应的整数(通过转换成一整型)。

返回值：

将当前对象表示的 float 值转换成 int 型值，且返回此结果。

覆盖：

类 Number 中的 intValue

 public long longValue()

返回当前 Float 对象对应的长整数(通过转换成一长整型)。

返回值：

将当前对象表示的 float 值转换成 long 型值，且返回此结果。

覆盖：

类 Number 中的 longValue

 public float floatValue()

返回当前 Float 对象对应的浮点值。

返回值：

当前对象对应的 float 值。

覆盖：

类 Number 中的 floatValue

 public double doubleValue()

返回当前 Float 对象对应的双精度浮点值。

覆盖：

类 Number 中的 doubleValue

 public int hashCode()

返回当前 Float 对象的哈希码。

返回值：

该对象的哈希值。

覆盖：

类 Object 中的 hashCode

 public boolean equals(Object obj)

比较当前对象和其它对象。 当且仅当参数非空，且为一单精度浮点型对象，并与当前对象有相同的值时，结果为 true。

注意在大多数情况下，对于 Float 类的两个实例 f1 和 f2, d1.equals(d2) 的值为 true，当且仅当

f1.floatValue() == f2.floatValue()

的值也为 true。但是也有下列两种例外：

• 如果 f1 和 f2 都表示 Float.NaN, 那么即使 Float.NaN==Float.NaN 的值为 false， equals 方法也将返回 true。
• 如果 f1 表示 +0.0f ， f2 表示-0.0f, 或相反情况， equal 方法将返回 false, 尽管 +0.0f==-0.0f 为 true。

返回值：

如果是相同对象则为 true，否则为 false。

覆盖：

类 Object 中的 equals

参见：

floatToIntBits

 public static native int floatToIntBits(float value)

返回单精度浮点数的位表示形式。 根据 IEEE 754 "单精度浮点型格式" 中的位布局规定，返回指定浮点参数的表示形式。

第 31 位表示浮点数的符号。 第 30-23 位表示浮点数的阶。 第 22-0 位表示浮点数的尾数。

如果参数为正无限大，那么结果为 0x7f800000。

如果参数为负无限大，那么结果为 0xff800000。

如果参数为 NaN，那么结果为 0x7fc00000。

参数：

value - 浮点数。

返回值：

浮点数的表示形式。

 public static native float intBitsToFloat(int bits)

返回给定位表示的相应的单精度浮点数。 参数是符合 IEEE 754 "单精度浮点型格式" 中的位布局规定的浮点值表示形式。

如果参数为 0x7f800000, 那么结果为正无限大。

如果参数为 0xff800000, 那么结果为负无限大。

如果参数在 0x7f800001 到 0x7f8fffff 或 0xff800001 到 0xff8fffff之间, 那么结果为 NaN。 Java 语言将 IEEE 754 中的所有 NaN 值表示为单一形式。

参数：

bits - 一整数。

返回值：

与给定值具有同一位模式的单精度浮点值。