java.lang.Object | |
↳ | java.lang.Double |
The Double class wraps a value of the primitive type double in an object. An object of type Double contains a single field whose type is double.
In addition, this class provides several methods for converting a double to a String and a String to a double, as well as other constants and methods useful when dealing with a double.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
double | MAX_VALUE | The largest positive finite value of type double. | |||||||||
double | MIN_VALUE | The smallest positive value of type double. | |||||||||
double | NEGATIVE_INFINITY | The negative infinity of type double. | |||||||||
double | NaN | A Not-a-Number (NaN) value of type double. | |||||||||
double | POSITIVE_INFINITY | The positive infinity of type double. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Double(double value)
Constructs a newly allocated Double object that represents the primitive
double argument.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
byte |
byteValue()
Returns the value of this Double as a byte (by casting to a byte).
| ||||||||||
static long |
doubleToLongBits(double value)
Returns a representation of the specified floating-point value according to
the IEEE 754 floating-point "double format" bit layout.
| ||||||||||
double |
doubleValue()
Returns the double value of this Double.
| ||||||||||
boolean |
equals(Object obj)
Indicates whether some other object is "equal to" this one.
| ||||||||||
float |
floatValue()
Returns the float value of this Double.
| ||||||||||
int |
hashCode()
Returns a hashcode for this Double object.
| ||||||||||
int |
intValue()
Returns the integer value of this Double (by casting to an int).
| ||||||||||
boolean |
isInfinite()
Returns true if this Double value is infinitely large in magnitude.
| ||||||||||
static boolean |
isInfinite(double v)
Returns true if the specified number is infinitely large in magnitude.
| ||||||||||
static boolean |
isNaN(double v)
Returns true if this Double value is the special Not-a-Number (NaN) value.
| ||||||||||
boolean |
isNaN()
Returns true if this Double value is the special Not-a-Number (NaN) value.
| ||||||||||
static double |
longBitsToDouble(long bits)
Returns the double-float corresponding to a given bit representation.
| ||||||||||
long |
longValue()
Returns the long value of this Double (by casting to a long).
| ||||||||||
static double |
parseDouble(String s)
Returns a new double initialized to the value represented by the specified
String, as performed by the valueOf method of class Double.
| ||||||||||
short |
shortValue()
Returns the value of this Double as a short (by casting to a short).
| ||||||||||
String |
toString()
Returns a String representation of this Double object.
| ||||||||||
static String |
toString(double d)
Returns a String representation of this Double object.
| ||||||||||
static Double |
valueOf(String s)
Returns a new Double object initialized to the value represented by the
specified string.
| ||||||||||
static Double | valueOf(double d) |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
The largest positive finite value of type double.
The smallest positive value of type double.
The negative infinity of type double.
A Not-a-Number (NaN) value of type double.
The positive infinity of type double.
Constructs a newly allocated Double object that represents the primitive double argument.
Returns the value of this Double as a byte (by casting to a byte).
Returns a representation of the specified floating-point value according to the IEEE 754 floating-point "double format" bit layout. Bit 63 (the bit that is selected by the mask 0x8000000000000000L) represents the sign of the floating-point number. Bits 62-52 (the bits that are selected by the mask 0x7ff0000000000000L) represent the exponent. Bits 51-0 (the bits that are selected by the mask 0x000fffffffffffffL) represent the significant (sometimes called the mantissa) of the floating-point number.
If the argument is positive infinity, the result is 0x7ff0000000000000L.
If the argument is negative infinity, the result is 0xfff0000000000000L.
If the argument is NaN, the result is 0x7ff8000000000000L.
In all cases, the result is a long integer that, when given to the longBitsToDouble(long) method, will produce a floating-point value equal to the argument to doubleToLongBits.
value | a double precision floating-point number. |
---|
Returns the double value of this Double.
Indicates whether some other object is "equal to" this one.
The equals
method implements an equivalence relation:
x
,
x.equals(x)
should return true
.
x
and
y
, x.equals(y)
should return true
if
and only if y.equals(x)
returns true
.
x
,
y
, and z
, if x.equals(y)
returns
true
and y.equals(z)
returns true
,
then x.equals(z)
should return true
.
x
and
y
, multiple invocations of x.equals(y) consistently
return true
or consistently return false
, provided
no information used in equals
comparisons on the object is
modified.
x
,
x.equals(null)
should return false
.
The equals method for class Object
implements the most
discriminating possible equivalence relation on objects; that is, for any
reference values x
and y
, this method returns
true
if and only if x
and y
refer to
the same object (x==y
has the value true
).
obj | the reference object with which to compare. |
---|
true
if this object is the same as the obj argument;
false
otherwise.Returns the float value of this Double.
Returns a hashcode for this Double object. The result is the exclusive OR of the two halves of the long integer bit representation, exactly as produced by the method doubleToLongBits(double), of the primitive double value represented by this Double object. That is, the hashcode is the value of the expression:
(int) (v ˆ (v >>> 32))where v is defined by:
long v = Double.doubleToLongBits(this.doubleValue());
Returns the integer value of this Double (by casting to an int).
Returns true if this Double value is infinitely large in magnitude.
Returns true if the specified number is infinitely large in magnitude.
v | the value to be tested. |
---|
Returns true if this Double value is the special Not-a-Number (NaN) value.
v | the value to be tested. |
---|
Returns true if this Double value is the special Not-a-Number (NaN) value.
Returns the double-float corresponding to a given bit representation. The argument is considered to be a representation of a floating-point value according to the IEEE 754 floating-point "double precision" bit layout. That floating-point value is returned as the result. If the argument is 0x7ff0000000000000L, the result is positive infinity.
If the argument is 0xfff0000000000000L, the result is negative infinity.
If the argument is any value in the range 0x7ff0000000000001L through 0x7fffffffffffffffL or in the range 0xfff0000000000001L through 0xffffffffffffffffL, the result is NaN. All IEEE 754 NaN values of type double are, in effect, lumped together by the Java programming language into a single value called NaN.
In all other cases, let s, e, and m be three values that can be computed from the argument:
int s = ((bits >> 63) == 0) ? 1 : -1; int e = (int) ((bits >> 52) & 0x7ffL); long m = (e == 0) ? (bits & 0xfffffffffffffL) << 1 : (bits & 0xfffffffffffffL) | 0x10000000000000L;
Then the floating-point result equals the value of the mathematical expression s·m·2e-1075.
bits | any long integer. |
---|
Returns the long value of this Double (by casting to a long).
Returns a new double initialized to the value represented by the specified String, as performed by the valueOf method of class Double.
s | the string to be parsed. |
---|
NumberFormatException | if the string does not contain a parsable double. |
---|
Returns the value of this Double as a short (by casting to a short).
Returns a String representation of this Double object. The primitive double value represented by this object is converted to a string exactly as if by the method toString of one argument.
Returns a String representation of this Double object. The primitive double value represented by this object is converted to a string exactly as if by the method toString of one argument.
Returns a new Double object initialized to the value represented by the specified string. The string s is interpreted as the representation of a floating-point value and a Double object representing that value is created and returned.
If s is null, then a NullPointerException is thrown.
Leading and trailing whitespace characters in s are ignored. The rest of s should constitute a FloatValue as described by the lexical rule:
FloatValue: Signopt FloatingPointLiteral
where Sign and FloatingPointLiteral are as defined in Section 3.10.2 of the
Java Language
Specification. If it does not have the form of a
FloatValue
, then a NumberFormatException is thrown.
Otherwise, it is regarded as representing an exact decimal value in the usual
"computerized scientific notation"; this exact decimal value is then
conceptually converted to an "infinitely precise" binary value that is then
rounded to type double by the usual round-to-nearest rule of IEEE 754
floating-point arithmetic. Finally, a new object of class Double is created
to represent the double value.
s | the string to be parsed. |
---|
NumberFormatException | if the string does not contain a parsable number. |
---|