类 java.lang.Double

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

public final class Double

extends Number

Double 类是双精度浮点型数据的对象包装类。 每个 Double 型对象包含单一的双精度浮点(double)型数据域。

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

变量索引

MAX_VALUE

双精度浮点数(double)可取的最大值。

MIN_VALUE

双精度浮点数(double)可取的最小值。

NaN

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

NEGATIVE_INFINITY

双精度浮点数(double)的负无限大。

POSITIVE_INFINITY

双精度浮点数(double)的正无限大。

TYPE

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

构造子索引

Double(double)

构造一 Double 对象，表示给定的 double 参数。

Double(String)

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

方法索引

byteValue()

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

doubleToLongBits(double)

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

doubleValue()

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

equals(Object)

比较当前对象和指定对象。

floatValue()

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

hashCode()

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

intValue()

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

isInfinite()

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

isInfinite(double)

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

isNaN()

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

isNaN(double)

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

longBitsToDouble(long)

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

longValue()

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

shortValue()

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

toString()

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

toString(double)

创建一 double 参数对应的串。

valueOf(String)

返回表示给定串对应的一个新的初始化后的 Double 对象。

变量

 public static final double POSITIVE_INFINITY

双精度浮点数(double)的正无限大。

 public static final double NEGATIVE_INFINITY

双精度浮点数(double)的负无限大。

 public static final double NaN

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

 public static final double MAX_VALUE

双精度浮点数(double)可取的最大值。

 public static final double MIN_VALUE

双精度浮点数(double)可取的最小值。

 public static final Class TYPE

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

构造子

 public Double(double value)

构造一 Double 对象，表示给定的 double 参数。

参数：

value - Double 对象表示的值。

 public Double(String s) throws NumberFormatException

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

参数：

s - 转换为 Double 型的串。

抛出： NumberFormatException

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

参见：

valueOf

方法

 public static String toString(double d)

创建一 double 参数对应的串。

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。

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

参数：

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

返回值：

参数对应的字符串。

 public static Double valueOf(String s) throws NumberFormatException

返回表示给定串对应的一个新的初始化后的 Double 对象。

参数：

s - 待分析的字符串。

返回值：

表示给定串对应的值的一个新创建的初始化后的 Double 对象。

抛出： NumberFormatException

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

 public static boolean isNaN(double v)

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

参数：

v - 测试的值。

返回值：

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

 public static boolean isInfinite(double v)

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

参数：

v - 测试的值。

返回值：

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

 public boolean isNaN()

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

返回值：

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

 public boolean isInfinite()

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

返回值：

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

 public String toString()

返回表示当前 Double 对象的相应串。 当前对象表示的基本 double 值转换为一恰当串，同带一参数的 toString 方法类似。

返回值：

表示当前对象的相应 String。

覆盖：

类 Object 中的 toString

参见：

toString

 public byte byteValue()

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

覆盖：

类 Number 中的 byteValue

 public short shortValue()

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

覆盖：

类 Number 中的 shortValue

 public int intValue()

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

返回值：

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

覆盖：

类 Number 中的 intValue

 public long longValue()

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

返回值：

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

覆盖：

类 Number 中的 longValue

 public float floatValue()

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

返回值：

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

覆盖：

类 Number 中的 floatValue

 public double doubleValue()

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

返回值：

当前对象对应的 double 值。

覆盖：

类 Number 中的 doubleValue

 public int hashCode()

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

返回值：

当前对象的哈希值。

覆盖：

类 Object 中的 hashCode

 public boolean equals(Object obj)

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

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

d1.doubleValue() == d2.doubleValue()

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

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

参数：

obj - 比较的对象。

返回值：

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

覆盖：

类 Object 中的 equals

 public static native long doubleToLongBits(double value)

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

第 63 位表示浮点数的符号。第 62-52 位表示浮点数的阶。第 51-0 位表示浮点数的尾数。

如果参数为正无限大，结果为 0x7ff0000000000000L。

如果参数为负无限大，结果为 0xfff0000000000000L。

如果参数为 NaN，结果为 0x7ff8000000000000L。

参数：

value - 一个双精度浮点数。

返回值：

浮点数的表示形式。

 public static native double longBitsToDouble(long bits)

返回给定位表示的相应的双精度浮点数。 根据 IEEE 754 "双精度浮点型格式" 中的位布局规定，返回指定浮点值的表示形式。 返回此浮点值表示。

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

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

如果参数在 0x7ff0000000000001L 到 0x7fffffffffffffffL 或 0xfff0000000000001L 到 0xffffffffffffffffL之间, 则结果为 NaN。 Java 语言将 IEEE 754 中的所有 NaN 值表示为一单一形式。

参数：

bits - 任一 long 整型数。

返回值：

与给定值具有同一位模式的 double 浮点值。