java.lang
클래스 Double

java.lang.Object 
  java.lang.Number 
      java.lang.Double

모든 구현된 인터페이스:

Serializable, Comparable <Double >

public final class Double
extends Number 
implements Comparable <Double >

Double 클래스는 원시형 double값을 객체에 랩 합니다. Double 형의 객체에는 형태가 double 단일 필드가 포함됩니다.

또한 이 클래스는 double를 String에 String를 double로 변환하는 각종 메서드나, double 처리시에 도움이 되는 정수 및 메서드도 제공합니다.

도입된 버전 :

JDK1. 0

관련 항목:

직렬화 된 형식

필드 개요

static double	MAX_VALUE double 형의 정의 최대 유한치 (2-2-52) ·21023 입니다.
static double	MIN_VALUE double 형의 정의 최소 유한치 2-1074 입니다.
static double	NaN double 형의 비수 (NaN) 치를 보관 유지하는 정수입니다.
static double	NEGATIVE_INFINITY double 형의 부의 무한대치를 보관 유지하는 정수입니다.
static double	POSITIVE_INFINITY double 형의 정의 무한대치를 보관 유지하는 정수입니다.
static int	SIZE double 치를 나타내는데 사용되는 비트수
static Class <Double >	TYPE double 원시형 을 나타내는 Class인스턴스입니다.

생성자 개요

Double (double value)
원시적 double인수를 나타낸다, 새롭게 할당할 수 있는 Double 객체를 구축합니다.

Double (String s)
캐릭터 라인으로 나타내지는 double 형의 부동 소수점을 나타내는 새롭게 할당할 수 있는 Double 객체를 구축합니다.

메서드 개요

byte	byteValue () 이 Double값을 (byte에 캐스트 하는 것으로써) byte로 서 리턴합니다.
static int	compare (double d1, double d2) 지정된 2개의 double값을 비교합니다.
int	compareTo (Double anotherDouble) 2개의 Double 객체를 수치적으로 비교합니다.
static long	doubleToLongBits (double value) IEEE 754 부동 소수점의 「더블 포맷 (double format)」비트 레이아웃에 따라, 지정된 부동 소수점의 값을 표현해 리턴합니다.
static long	doubleToRawLongBits (double value) IEEE 754 부동 소수점의 「더블 포맷 (double format)」비트 레이아웃에 따라, 비수 (NaN) 치를 보관 유지하는 지정된 부동 소수점치의 표현을 리턴합니다.
double	doubleValue () 이 Double 객체의 double값을 리턴합니다.
boolean	equals (Object obj) 이 객체가 지정된 객체와 비교합니다.
float	floatValue () 이 Double 객체의 float값을 리턴합니다.
int	hashCode () 이 Double 객체의 해시 코드를 리턴합니다.
int	intValue () 이 Double값을 (int 형에 캐스트 하는 것으로써) int로 서 리턴합니다.
boolean	isInfinite () 이 Double값의 절대값이 무한량인 경우에는 true를, 그렇지 않은 경우에는 false를 리턴합니다.
static boolean	isInfinite (double v) 지정된 수치의 절대값이 무한량인 경우에는 true를, 그렇지 않은 경우에는 false를 리턴합니다.
boolean	isNaN () 이 Double값이 비수 (NaN)인 경우에는 true를, 그렇지 않은 경우는 false를 리턴합니다.
static boolean	isNaN (double v) 지정된 수값이 비수 (NaN)인 경우에는 true를, 그렇지 않은 경우는 false를 리턴합니다.
static double	longBitsToDouble (long bits) 지정된 비트 표현과 대응하는 double값을 리턴합니다.
long	longValue () 이 Double값을 (long 형에 캐스트 하는 것으로써) long로 서 리턴합니다.
static double	parseDouble (String s) Double 클래스의 valueOf 메서드를 실행했을 경우와 같게, 지정된 String가 나타내는 값에 초기화된 새로운 double값을 리턴합니다.
short	shortValue () 이 Double값을 (short에 캐스트 하는 것으로써) short로 서 리턴합니다.
static String	toHexString (double d) double인수의 16 진수 캐릭터 라인 표현을 리턴합니다.
String	toString () 이 Double 객체의 캐릭터 라인 표현을 리턴합니다.
static String	toString (double d) double인수의 캐릭터 라인 표현을 리턴합니다.
static Double	valueOf (double d) 지정한 double 치를 나타내는 Double 인스턴스를 리턴합니다.
static Double	valueOf (String s) 캐릭터 라인 인수 s로 나타내지는 double값을 보관 유지하는 Double 객체를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

필드의 상세

POSITIVE_INFINITY

public static final double POSITIVE_INFINITY

double 형의 정의 무한대치를 보관 유지하는 정수입니다. Double.longBitsToDouble(0x7ff0000000000000L)에 의해 리턴된 값과 같습니다.

관련 항목:

정수 필드값

NEGATIVE_INFINITY

public static final double NEGATIVE_INFINITY

double 형의 부의 무한대치를 보관 유지하는 정수입니다. Double.longBitsToDouble(0xfff0000000000000L)에 의해 리턴된 값과 같습니다.

관련 항목:

정수 필드값

NaN

public static final double NaN

double 형의 비수 (NaN) 치를 보관 유지하는 정수입니다. Double.longBitsToDouble(0x7ff8000000000000L)에 의해 리턴된 값과 같습니다.

관련 항목:

정수 필드값

MAX_VALUE

public static final double MAX_VALUE

double 형의 정의 최대 유한치 (2-2^-52) ·2¹⁰²³ 입니다. 16 진수 부동 소수점 리터럴 0x1.fffffffffffffP+1023로 동등하고, Double.longBitsToDouble(0x7fefffffffffffffL)와 도 동등합니다.

관련 항목:

정수 필드값

MIN_VALUE

public static final double MIN_VALUE

double 형의 정의 최소 유한치 2^-1074 입니다. 16 진수 부동 소수점 리터럴 0x0. 0000000000001P-1022로 동등하고, Double.longBitsToDouble(0x1L)와 도 동등합니다.

관련 항목:

정수 필드값

SIZE

public static final int SIZE

double 치를 나타내는데 사용되는 비트수

도입된 버전 :

1.5

관련 항목:

정수 필드값

TYPE

public static final Class <Double > TYPE

double 원시형 을 나타내는 Class인스턴스입니다.

도입된 버전 :

JDK1. 1

생성자 상세

Double

public Double(double value)

원시적 double인수를 나타낸다, 새롭게 할당할 수 있는 Double 객체를 구축합니다.

파라미터:

value - Double에 의해 나타내지는 값

Double

public Double(String  s)
       throws NumberFormatException 

캐릭터 라인으로 나타내지는 double 형의 부동 소수점을 나타내는 새롭게 할당할 수 있는 Double 객체를 구축합니다. 캐릭터 라인은, valueOf 메서드와 같게 double 치에 변환됩니다.

파라미터:

s - Double로 변환하는 캐릭터 라인

예외:

NumberFormatException - 캐릭터 라인이 구문 분석 가능한 수치를 포함하지 않는 경우

관련 항목:

valueOf(java.lang.String)

메서드의 상세

toString

public static String  toString(double d)

double인수의 캐릭터 라인 표현을 리턴합니다. 아래의 문자는 모두 ASCII 문자입니다.

• 인수가 NaN인 경우, 변환 후의 캐릭터 라인은 「NaN」
• 그렇지 않은 경우, 변환 후의 캐릭터 라인은 인수의 부호와 절대치를 나타낸다. 부호가 부의 경우, 변환 후의 캐릭터 라인의 최초의 문자는 「-」(「\u002D」). 부호가 정의 경우, 변환 후의 캐릭터 라인에 부호 문자는 표시되지 않는다. 절대치 m에 대해서는 다음대로
  • m가 무한대의 경우는 「Infinity」라고 하는 캐릭터 라인으로 나타낸다. 즉, 정의 무한대는 「Infinity」, 부의 무한대는 「-Infinity」라고 된다
  • m가 제로의 경우는 「0.0」(이)라고 하는 캐릭터 라인으로 나타낸다. 즉, 부의 제로는 「-0. 0」, 정의 제로는 「0.0」(이)라고 된다
  • m가 10^-3 이상으로 10⁷ 미만의 경우는 m 정수부로서 선두에 제로가 붙지 않는 10 진수, 소수점 「. 」( 「'\u002E」), m 소수부를 나타내는 1 자리수 이상의 10 진수가 이 순서로 나란해진 형태로 표현된다
  • m가 10^-3 미만, 혹은 10⁷ 이상의 경우는 부동 소수점 표시 형식에서 표현한다. 예를 들어, n가 10ⁿ <= m < 10ⁿ⁺¹에 해당하는 일의의 정수, a가 1 <= a < 10 이 되는 것 같은, m와 10ⁿ 수학적으로 정확한 상으로 한다. 이 경우 절대치는 메서드 Integer.toString(int) 로부터 돌려주고졌던 대로a 정수부인 1 자리수의 10 진수, 「. 」( 「\u002E」), a 소수부를 나타내는 10 진수, 문자 「E」( 「\u0045」), n를 나타내는 10 진정수가 이 순서로 나란해진 형태로 표현된다

m 또는 a 소수부로서 출력하는 자리수를 검토해 봅시다. 소수부를 나타내는 자리수는 1 자리수 이상이 필요합니다. double 형의 인접하는 값으로부터 인수를 일의에 식별하는데 최저한 필요한 자리수로의해 주세요. 예를 들어 제로가 아닌 유한의 인수를 지정해 이 메서드로 작성한 10 진수 표기를 x 로 합니다. 이 경우 d는 x double 형의 최근 닮고 값이 아니면 안됩니다. 즉, 2개의 double값이 균등하게 x에 근사 하고 있는 경우이면, d는 2개의 값의 어느 쪽인지 나오지 않으면 안되어, 유효한 최하정도 비트는 0 이 아니면 안됩니다.

부동 소수점치의 지역 대응된 캐릭터 라인 표현을 작성하는 경우, NumberFormat 서브 클래스를 사용합니다.

파라미터:

d - 변환 대상의 double

반환값:

이 인수의 캐릭터 라인 표현

toHexString

public static String  toHexString(double d)

double인수의 16 진수 캐릭터 라인 표현을 리턴합니다. 아래의 문자는 모두 ASCII 문자입니다.

• 인수가 NaN인 경우, 변환 후의 캐릭터 라인은 「NaN」
• 그렇지 않은 경우, 변환 후의 캐릭터 라인은 인수의 부호와 절대치를 나타낸다. 부호가 부의 경우, 변환 후의 캐릭터 라인의 최초의 문자는 「-」( 「\u002D」). 부호가 정의 경우, 변환 후의 캐릭터 라인에 부호 문자는 표시되지 않는다. 절대치 m에 대해서는 다음대로
  • m가 무한대의 경우는 「Infinity」라고 하는 캐릭터 라인으로 나타낸다. 즉, 정의 무한대는 「Infinity 」, 부의 무한대는 「-Infinity」라고 된다
  • m가 제로의 경우는 「0x0. 0p0」이라고 하는 캐릭터 라인으로 나타낸다. 즉, 부의 제로는 「-0x0. 0p0 」, 정의 제로는 「0x0. 0p0」이라고 된다
  • m가 double값의인 경우는 유효 숫자와 지수의 필드를 나타내는데 부분 캐릭터 라인이 사용된다. 유효 숫자는 캐릭터 라인 「0x1. 」라고, 소수부로서 나머지의 유효 숫자의 소문자의 16 진표현을 계속해 나타내진다. 모든 자리수가 0 이 아닌 한 (모든 것이 0인 경우는 단일의 0을 사용), 16 진표현의 말미의 0 은 삭제된다. 다음에 지수는 지수치로 Integer.toString를 호출해 생성할 때와 같이, 「p」라고 거기에 계속되는 완전한 지수의 10 진수 캐릭터 라인으로 나타내진다
  • m가 비정규 표현의 double치의 경우는 유효 숫자는 캐릭터 라인 「0x0. 」라고, 소수부로서 나머지의 유효 숫자의 16 진표현을 계속해 나타내진다. 16 진표현의 말미의 0 은 삭제된다. 다음에 지수는 「p-1022」로 나타내진다. 비정규의 유효치에는 적어도 1개의 제로가 아닌 자리수가 없으면 안 된다

례

부동 소수점치	16 진수 캐릭터 라인
1.0	0x1. 0p0
-1. 0	-0x1. 0p0
2.0	0x1. 0p1
3.0	0x1. 8p1
0.5	0x1. 0p-1
0.25	0x1. 0p-2
Double.MAX_VALUE	0x1.fffffffffffffp1023
Minimum Normal Value	0x1. 0p-1022
Maximum Subnormal Value	0x0.fffffffffffffp-1022
Double.MIN_VALUE	0x0. 0000000000001p-1022

파라미터:

d - 변환 대상의 double

반환값:

인수의 16 진수 캐릭터 라인 표현

도입된 버전 :

1.5

valueOf

public static Double  valueOf(String  s)
                      throws NumberFormatException 

캐릭터 라인 인수 s로 나타내지는 double값을 보관 유지하는 Double 객체를 리턴합니다.

s가 null인 경우는 NullPointerException가 발생 됩니다.

s 내의 선두와 말미의 공백 문자는 무시됩니다. 공백 문자는 String.trim() 메서드로 삭제될 때와 같이 삭제됩니다. 즉, ASCII 공백 문자와 제어 문자의 양쪽 모두가 삭제됩니다. s 나머지의 문자가 다음의 자구 구문 규칙에 따라 FloatValue를 구성합니다.

여기서, Sign, FloatingPointLiteral, HexNumeral, HexDigits, SignedInteger 및 FloatTypeSuffix는 「Java 언어 사양」의 자구 구조 섹션의 정의에 따릅니다. s가 FloatValue 형식이 아닌 경우, NumberFormatException가 발생 됩니다. 그렇지 않은 경우, s는 보통 의 「부동 소수점 표기」, 즉 정확한 10 진수 또는 16 진수를 나타내고 있다고 보여집니다. 이 정확한 수치는 개념상은 「무한하게 정확한 바이너리치」에 변환되고 나서, IEEE 754 부동 소수점 계산법에 따르는 보통 의 최근 닮고 값 둥근 법 (제로치의 부호 보관 유지를 포함한다)에 따라 double 형에 말 수 있습니다. 마지막으로double값을 나타내는 Double 객체가 리턴됩니다 .

부동 소수점치의 지역 대응된 캐릭터 라인 표현을 해석하는 경우, NumberFormat 서브 클래스를 사용합니다.

부동 소수점 리터럴의 형태를 결정하는 지시자의 말미 형식 지시자 (1.0f는 float 치, 1.0d는 double 치)는 이 메서드의 결과에 영향을 주지 않습니다. 즉, 입력 캐릭터 라인의 수치는 타겟의 부동 소수점형에 직접 변환됩니다. 캐릭터 라인을 float로 변환해, float를 double로 변환하는 2 단계의 순서는 캐릭터 라인을 double로 변환하는 것과 등가가 아닙니다. 예를 들어, float 리터럴 0.1f는 double 치 0.10000000149011612로 같습니다만, float 리터럴 0.1f는 double 리터럴 0.1 과는 다른 수치를 나타냅니다. 수치 0.1을 바이너리 부동 소수점수(실수)로 정확하게 나타낼 수 없습니다.

무효인 캐릭터 라인으로 이 메서드가 불려가 거나NumberFormatException가 Throw 되거나 하지 않게 하려면, 아래의 정규 표현을 사용해 입력 캐릭터 라인을 스크리닝 할 수 있습니다 .

        final String Digits     = "(\\p{Digit}+)";
  final String HexDigits  = "(\\p{XDigit}+)";
        // an exponent is 'e' or 'E' followed by an optionally 
        // signed decimal integer.
        final String Exp        = "[eE][+-]? "+Digits;
        final String fpRegex    =
            ("[\\x00-\\x20]*"+  // Optional leading "whitespace"
             "[+-]? (" + // Optional sign character
             "NaN|" +           // "NaN" string
             "Infinity|" +      // "Infinity" string

             // A decimal floating-point string representing a finite positive
             // number without a leading sign has at most five basic pieces:
             // Digits .  Digits ExponentPart FloatTypeSuffix
             // 
             // Since this method allows integer-only strings as input
             // in addition to strings of floating-point literals, the
             // two sub-patterns below are simplifications of the grammar
             // productions from the Java Language Specification, 2nd 
             // edition, section 3.10. 2.

             // Digits . _opt Digits_opt ExponentPart_opt FloatTypeSuffix_opt
             "((("+Digits+"(\\. )? ("+Digits+"? )("+Exp+")? )|"+

             // .  Digits ExponentPart_opt FloatTypeSuffix_opt
             "(\\. ("+Digits+")("+Exp+")? )|"+

       // Hexadecimal strings
       "((" +
        // 0[xX] HexDigits . _opt BinaryExponent FloatTypeSuffix_opt
        "(0[xX]" + HexDigits + "(\\. )? )|" +

        // 0[xX] HexDigits_opt .  HexDigits BinaryExponent FloatTypeSuffix_opt
        "(0[xX]" + HexDigits + "? (\\. )" + HexDigits + ")" +

        ")[pP][+-]? " + Digits + "))" +
             "[fFdD]? ))" +
             "[\\x00-\\x20]*");// Optional trailing "whitespace"
            
  if (Pattern.matches(fpRegex, myString))
            Double.valueOf(myString); // Will not throw NumberFormatException
        else {
            // Perform suitable alternative action
        }
 

파라미터:

s - 구문 분석 되는 캐릭터 라인

반환값:

String인수에 의해 나타내지는 값을 보관 유지하는 Double 객체

예외:

NumberFormatException - 캐릭터 라인이 구문 분석 가능한 수치를 포함하지 않는 경우

valueOf

public static Double  valueOf(double d)

지정한 double 치를 나타내는 Double 인스턴스를 리턴합니다. 새로운 Double 인스턴스가 불필요한 경우, 보통 이 메서드가 생성자 Double(double)에 우선해 사용됩니다. 그 이유는 이 메서드가 빈번하게 요구되는 값을 캐쉬하므로 조작에 필요한 영역이나 시간이 훨씬 적어도 되는 경우가 많기 때문입니다.

파라미터:

d - double값

반환값:

d를 나타내는 Double 인스턴스

도입된 버전 :

1.5

parseDouble

public static double parseDouble(String  s)
                          throws NumberFormatException 

Double 클래스의 valueOf 메서드를 실행했을 경우와 같게, 지정된 String가 나타내는 값에 초기화된 새로운 double값을 리턴합니다.

파라미터:

s - 구문 분석 되는 캐릭터 라인

반환값:

캐릭터 라인 인수로 나타내지는 double 치

예외:

NumberFormatException - 캐릭터 라인이 구문 분석 가능한 double값을 포함하지 않는 경우

도입된 버전 :

1.2

관련 항목:

valueOf(String)

isNaN

public static boolean isNaN(double v)

지정된 수값이 비수 (NaN)인 경우에는 true를, 그렇지 않은 경우는 false를 리턴합니다.

파라미터:

v - 판정되는 값

반환값:

인수의 값이 NaN 인 경우는 true, 그렇지 않은 경우는 false

isInfinite

public static boolean isInfinite(double v)

지정된 수치의 절대값이 무한량인 경우에는 true를, 그렇지 않은 경우에는 false를 리턴합니다.

파라미터:

v - 판정되는 값

반환값:

인수가 정 또는 부의 무한치의 경우는 true, 그렇지 않은 경우는 false

isNaN

public boolean isNaN()

이 Double값이 비수 (NaN)인 경우에는 true를, 그렇지 않은 경우는 false를 리턴합니다.

반환값:

이 객체가 나타내는 값이 NaN 인 경우는 true, 그렇지 않은 경우는 false

isInfinite

public boolean isInfinite()

이 Double값의 절대값이 무한량인 경우에는 true를, 그렇지 않은 경우에는 false를 리턴합니다.

반환값:

이 객체가 나타내는 값이 정의 무한대 또는 부의 무한대인 경우는 true, 그렇지 않은 경우는 false

toString

public String  toString()

이 Double 객체의 캐릭터 라인 표현을 리턴합니다. 이 객체가 나타내는 원시적 double값은 1개의 인수를 취하는 toString 메서드를 실행했을 경우와 같은 캐릭터 라인에 변환됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 String 표현

관련 항목:

toString(double)

byteValue

public byte byteValue()

이 Double값을 (byte에 캐스트 하는 것으로써) byte로 서 리턴합니다.

오버라이드(override):

클래스 Number 내의 byteValue

반환값:

byte 형에 변환된 이 객체가 나타내는 double 치

도입된 버전 :

JDK1. 1

shortValue

public short shortValue()

이 Double값을 (short에 캐스트 하는 것으로써) short로 서 리턴합니다.

오버라이드(override):

클래스 Number 내의 shortValue

반환값:

short 형에 변환된 이 객체가 나타내는 double 치

도입된 버전 :

JDK1. 1

intValue

public int intValue()

이 Double값을 (int 형에 캐스트 하는 것으로써) int로 서 리턴합니다.

정의:

클래스 Number 내의 intValue

반환값:

int 형에 변환된 이 객체가 나타내는 double 치

longValue

public long longValue()

이 Double값을 (long 형에 캐스트 하는 것으로써) long로 서 리턴합니다.

정의:

클래스 Number 내의 longValue

반환값:

long 형에 변환된 이 객체가 나타내는 double 치

floatValue

public float floatValue()

이 Double 객체의 float값을 리턴합니다.

정의:

클래스 Number 내의 floatValue

반환값:

float 형에 변환된 이 객체가 나타내는 double 치

도입된 버전 :

JDK1. 0

doubleValue

public double doubleValue()

이 Double 객체의 double값을 리턴합니다.

정의:

클래스 Number 내의 doubleValue

반환값:

이 객체가 나타내는 double 치

hashCode

public int hashCode()

이 Double 객체의 해시 코드를 리턴합니다. 계산된 결과는 doubleToLongBits(double) 메서드의 결과와 완전히 똑같이, 이 Double 객체가 나타내는 원시적 double값의 long 정수를 비트 표현한 상위 32 비트와 하위 32 비트의 배타적 논리합이 됩니다. 즉, 해시 코드는 다음의 식의 값입니다.

 (int)(v^(v>>>32))

다만, v는 다음의 식에 의해 정의됩니다.

 long v = Double.doubleToLongBits(this.doubleValue());
 

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 hash code 치

관련 항목:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object  obj)

이 객체가 지정된 객체와 비교합니다. 결과가 true가 되는 것은 인수가 null이 아니고, 이 객체가 나타내는 double 치와 같은 값을 보관 유지하는 double를 나타내는 Double 객체인 경우만입니다. 이 때문에 2개의 double값이 동일하다고 보여지는 것은, doubleToLongBits(double) 메서드를 각 치에 적용했을 때에 동일한 long값이 리턴된인 경우만입니다.

대부분의 경우, Double 클래스의 d1 및 d2 라고 하는 2개의 인스턴스에 대해, d1.equals(d2)값이 true가 되는 것은 다음의 식의 값이 true가 되는 경우만입니다.

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

그러나, 예외 사항도 2개 있습니다.

• d1와 d2 양쪽 모두가 Double.NaN을 나타내, Double.NaN==Double.NaN값이 false인 것에도 불구하고, equals 메서드가 true를 돌려주는 경우
• d1가 +0. 0을 나타내, d2가 -0. 0을 나타내든가 혹은 d1가 -0. 0을 나타내, d2가 +0. 0을 나타내는 경우로+0. 0==-0. 0값이 true인 것에도 불구하고, equal 테스트의 값이 false인 경우

이 정의에의해 해시 테이블은 올바르게 동작합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 객체

반환값:

객체가 같은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

doubleToLongBits(double)

doubleToLongBits

public static long doubleToLongBits(double value)

IEEE 754 부동 소수점의 「더블 포맷 (double format)」비트 레이아웃에 따라, 지정된 부동 소수점의 값을 표현해 리턴합니다.

비트 63 (마스크 0x8000000000000000L에 의해 선택되는 비트)은 부동 소수점의 부호를 나타냅니다. 비트 62-52 (마스크 0x7ff0000000000000L에 의해 선택되는 비트)는 지수를 나타냅니다. 비트 51-0 (마스크 0x000fffffffffffffL에 의해 선택되는 비트)는 부동 소수점의 유효치 (가수로 불리는 경우도 있다)를 나타냅니다.

인수가 정의 무한대치의 경우는 0x7ff0000000000000L가 리턴됩니다 .

인수가 부의 무한대치의 경우는 0xfff0000000000000L가 리턴됩니다 .

인수가 NaN인 경우는 0x7ff8000000000000L가 리턴됩니다 .

어느 경우도, 리턴된 값은 long 정수이며, longBitsToDouble(long) 메서드를 지정하면, doubleToLongBits에 의 인수와 같은 부동 소수점값이 됩니다 (모든 NaN 값이 단일의 「정규」NaN 치에 수납되는 것을 제외한다).

파라미터:

value - double 정밀도의 부동 소수점치

반환값:

부동 소수점치를 나타내는 비트

doubleToRawLongBits

public static long doubleToRawLongBits(double value)

IEEE 754 부동 소수점의 「더블 포맷 (double format)」비트 레이아웃에 따라, 비수 (NaN) 치를 보관 유지하는 지정된 부동 소수점치의 표현을 리턴합니다.

비트 63 (마스크 0x8000000000000000L에 의해 선택되는 비트)은 부동 소수점의 부호를 나타냅니다. 비트 62-52 (마스크 0x7ff0000000000000L에 의해 선택되는 비트)는 지수를 나타냅니다. 비트 51-0 (마스크 0x000fffffffffffffL에 의해 선택되는 비트)는 부동 소수점의 유효치 (가수로 불리는 경우도 있다)를 나타냅니다.

인수가 정의 무한대치의 경우는 0x7ff0000000000000L가 리턴됩니다 .

인수가 부의 무한대치의 경우는 0xfff0000000000000L가 리턴됩니다 .

인수가 NaN인 경우, 리턴된 값은 실제의 NaN 치를 나타내는 long 정수입니다. doubleToLongBits 메서드와는 달라, doubleToRawLongBits 메서드가 모든 비트 패턴 encode NaN를 단일의 정규 NaN 치에 수납할 것은 없습니다.

어느 경우도, 리턴된 값은 long 정수이며, longBitsToDouble(long) 메서드를 지정하면, doubleToRawLongBits에 의 인수와 같은 부동 소수점값이 됩니다.

파라미터:

value - double 정밀도의 부동 소수점치

반환값:

부동 소수점치를 나타내는 비트

longBitsToDouble

public static double longBitsToDouble(long bits)

지정된 비트 표현과 대응하는 double값을 리턴합니다. 인수는 IEEE 754 부동 소수점 「배정밀도」비트 배열에 따른 부동 소수점 표현이라고 보여집니다.

인수가 0x7ff0000000000000L인 경우는 정의 무한대값이 리턴됩니다 .

인수가 0xfff0000000000000L인 경우는 부의 무한대값이 리턴됩니다 .

인수가 0x7ff0000000000001L ~ 0x7fffffffffffffffL, 또는 0xfff0000000000001L ~ 0xffffffffffffffffL 범위내의 값인 경우, 결과는 NaN가 됩니다. Java 제공하는 IEEE 754 부동 소수점 연산은 형태가 같아 비트 패턴이 다른 2개의 NaN 치를 구별할 수 없습니다. NaN 개별의 값은, Double.doubleToRawLongBits를 사용하는 경우에만 식별 가능합니다.

그 다른 경우에서는 s, e 및 m 3개의 값에 대해 다음의 인수로부터 계산할 수 있다고 합니다.

 int s = ((bits >>
 63) == 0) ?  1 :
 -1;
 int e = (int)((bits >>
 52) & 0x7ffL);
 long m = (e == 0) ?  (bits & 0xfffffffffffffL) <<
 1 :
 (bits & 0xfffffffffffffL) | 0x10000000000000L;

이 경우 부동 소수점치의 결과는 수식 s·m·2^e-1075 값과 동일해집니다.

이 메서드는 long인수와 전혀 같은 비트 패턴을 가지는 double NaN를 돌려줄 수가 없을 가능성이 있습니다. IEEE 754 에서는 2 종류의 NaN ( 「시그널을 발생하지 않는 NaN」와「시그널을 발생하는 NaN」)를 구별합니다. 2 종류의 NaN 차이는 보통 Java 에서는 확인할 수 없습니다. 시그널을 발생하는 NaN 에서의 산술 연산에서는 시그널을 발생하는 NaN 가 이종이면서 같은 비트 패턴을 가지는 시그널을 발생하지 않는 NaN 로 바뀝니다. 다만, 시그널을 발생하는 NaN를 단지 카피하는 일부의 프로세서도, 이 변환도 실시합니다. 특히, 시그널을 발생하는 NaN를 복사해, 호출측의 메서드에 돌려주는 것으로 이 변환을 실행할 수 있습니다. 따라서, longBitsToDouble는 시그널을 발생하는 NaN 비트 패턴을 가지는 double를 돌려줄 수가 없을 가능성이 있습니다. 그 결과, 일부의 long값에서는 doubleToRawLongBits(longBitsToDouble(start))는 start와 등가가 아닌 경우가 있습니다. 더해, 어느 특정의 비트 패턴이 시그널을 발생하는 NaN를 나타낼까는 플랫폼에 따라서 다릅니다. 시그널을 발생하지 않는가 시그널을 발생할까에 관계없이, 모든 NaN는 위에 나타내는 NaN 범위에 없으면 안됩니다.

파라미터:

bits - long 정수

반환값:

같은 비트 패턴을 가지는 double 부동 소수점치

compareTo

public int compareTo(Double  anotherDouble)

2개의 Double 객체를 수치적으로 비교합니다. 이 메서드에 한 비교는 Java 언어의 수치 비교 연산자 (<, <=, ==, >= >)를 원시적 double 치에 적용했을 경우란 다음의 2 점으로써 다릅니다.

• 이 메서드에서는 Double.NaN는 그 자체와 동일하고, 다른 모든 double 치 (Double.POSITIVE_INFINITY를 포함한다)보다 크다고 보여진다
• 이 메서드에서는 0.0d는 -0. 0d 보다 크다고 보여진다

이렇게 해, 메서드에 의해 적용되는 Double 객체의 자연 순서부로 「equals와 의 일관성」이 확보됩니다.

정의:

인터페이스 Comparable <Double > 내의 compareTo

파라미터:

anotherDouble - 비교 대상의 Double

반환값:

anotherDouble가 이 Double와 같은 수치의 경우는 값 0. Double가 anotherDouble 보다 작은 수치의 경우는 0 보다 작은 값. Double가 anotherDouble 보다 큰 수치의 경우는 0 보다 큰 값

도입된 버전 :

1.2

compare

public static int compare(double d1,
                          double d2)

지정된 2개의 double값을 비교합니다. 리턴된 정수값 의 부호는 다음의 호출로 리턴된 정수의 부호와 같게 됩니다.

    new Double(d1). compareTo(new Double(d2))
 

파라미터:

d1 - 비교하는 최초의 double

d2 - 비교하는 2번째의 double

반환값:

d1값이 d2와 동일한 경우는 값 0, d1값이 d2 보다 작은 경우는 0 보다 작은 값, d1값이 d2 보다 큰 경우는 0 보다 큰 값

도입된 버전 :

1.4