java.math
클래스 BigDecimal

java.lang.Object 
  |
  +--java.lang.Number 
        |
        +--java.math.BigDecimal

모든 구현 인터페이스:

Comparable , Serializable

public class BigDecimal

extends Number

implements Comparable

변경이 불가능한, 임의 정밀도의 부호 첨부 10 진수입니다. BigDecimal 는 임의 정밀도의 「스케일 없음의 정수치」라고, 소수점 이하의 자리수를 나타내는 부가 아닌 32 비트 정수의 「스케일」로 구성됩니다. BigDecimal 로 나타내지는 수치는 (unscaledValue/10^scale) 입니다. BigDecimal 는 기본 산술, 스케일 조작, 비교, 핫싱, 및 서식 변환의 연산을 제공합니다.

BigDecimal 클래스에서는 소수부를 파기할 수 있는 연산 (,divide(BigDecimal, int, int) , 및 setScale(int, int) )에 대해서 유저가 명시적으로 둥근 동작을 지정해, 유저가 둥근 동작을 완전하게 제어할 수 있게 합니다. 이 때문에, 8 kr의 「둥근 모드」가 준비되어 있습니다.

BigDecimal 의 스케일 조작에는 슬캘링/둥근 연산과 소수점 이동 연산의 2 종류가 있습니다. 슬캘링/둥근 연산 (setScale)은 값이 오퍼랜드의 값과 거의 (또는 정확히) 동일하지만 스케일은 지정된 값인 BigDecimal 를 돌려줍니다. 이 연산에서는 값에 대해요 두일까 영향으로 수치의 정밀도가 상하합니다. 소수점 이동 연산 (movePointLeft(int) 와 movePointRight(int) )는 지정한 방향으로 지정한 자리수만 소수점을 이동하는 것으로써 오퍼랜드로부터 작성되는 BigDecimal 를 돌려줍니다. 이 연산은 정밀도에 영향을 주는 일 없이 수치의 값을 변경합니다.

설명을 알기 쉽고 간결하게 하기 위해서, BigDecimal 메소드의 설명에서는 전체를 통해 의사 코드를 사용합니다. 의사 코드식 (i + j) 은 값이 BigDecimal i 의 값과 BigDecimal j 의 값의 화인 BigDecimal 를 나타냅니다. 의사 코드식 (i == j) 은 BigDecimal i 가 BigDecimal j 와 같은 값을 나타내는 경우에만진인 것을 나타냅니다. 다른 의사 코드식도 똑같이 해석됩니다.

주: BigDecimal 를 SortedMap 의 키 또는 SortedSet 의 요소로서 사용하는 경우는 주의해 주세요. 이것은 BigDecimal 의 자연 순서부가 equals 와 모순되기 때문입니다. 자세한 것은 Comparable ,SortedMap 또는 SortedSet 를 참조해 주세요.

이 클래스의 메소드 및 constructor 은 모두, 입력 파라메이타에 대해서 null 오브젝트 참조가 건네받으면(자) NullPointerException 를 슬로우 합니다.

관련 항목:

BigInteger , SortedMap , SortedSet , 직렬화 된 형식

필드의 개요

static int	ROUND_CEILING 정의 무한대에 가까워지도록(듯이) 마는 모드입니다.
static int	ROUND_DOWN 0 에 가까워지도록(듯이) 마는 모드입니다.
static int	ROUND_FLOOR 부의 무한대에 가까워지도록(듯이) 마는 모드입니다.
static int	ROUND_HALF_DOWN 「가장 가까운 숫자」에 마는 모드입니다.
static int	ROUND_HALF_EVEN 「가장 가까운 숫자」에 마는 모드입니다.
static int	ROUND_HALF_UP 「가장 가까운 숫자」에 마는 모드입니다.
static int	ROUND_UNNECESSARY 요구되는 연산의 결과가 정확하고, 둥근이 필요하지 않은 것을 나타내는 둥근 모드입니다.
static int	ROUND_UP 0 로부터 멀어지도록(듯이) 마는 모드입니다.

생성자의 개요

BigDecimal (BigInteger val)
BigInteger 를 BigDecimal 로 변환합니다.

BigDecimal (BigInteger unscaledVal, int scale)
BigInteger 의 스케일 없음의 값과 int 스케일을 BigDecimal 로 변환합니다.

BigDecimal (double val)
double 를 BigDecimal 로 변환합니다.

BigDecimal (String val)
BigDecimal 의 String 표현을 BigDecimal 로 변환합니다.

메소드의 개요

BigDecimal	abs () 값이 이 BigDecimal 의 절대치로 스케일이 this.scale() 의 BigDecimal 를 돌려줍니다.
BigDecimal	add (BigDecimal val) 값이 (this + val) 로 스케일이 max(this.scale(), val.scale()) 의 BigDecimal 를 돌려줍니다.
int	compareTo (BigDecimal val) 이 BigDecimal 과 지정된 BigDecimal 를 비교합니다.
int	compareTo (Object o) 이 BigDecimal 과 지정된 Object 를 비교합니다.
BigDecimal	divide (BigDecimal val, int roundingMode) 값이 (this / val) 로 스케일이 this.scale() 인 BigDecimal 를 돌려줍니다.
BigDecimal	divide (BigDecimal val, int scale, int roundingMode) 값이 (this / val) 로, 스케일이 지정된 것인 BigDecimal 를 돌려줍니다.
double	doubleValue () 이 BigDecimal 를 double 로 변환합니다.
boolean	equals (Object x) 이 BigDecimal 와 지정된 Object 가 동일한지 어떤지를 비교합니다.
float	floatValue () 이 BigDecimal 를 float 로 변환합니다.
int	hashCode () 이 BigDecimal 의 해시 코드를 돌려줍니다.
int	intValue () 이 BigDecimal 를 int 로 변환합니다.
long	longValue () 이 BigDecimal 를 long 로 변환합니다.
BigDecimal	max (BigDecimal val) 이 BigDecimal 와 val 의 최대치를 돌려줍니다.
BigDecimal	min (BigDecimal val) 이 BigDecimal 와 val 의 최소치를 돌려줍니다.
BigDecimal	movePointLeft (int n) 소수점을 n 형좌에 이동해 이것에 동일한 BigDecimal 를 돌려줍니다.
BigDecimal	movePointRight (int n) 소수점이 지정된 자리수만 우측향에 이동시킵니다.
BigDecimal	multiply (BigDecimal val) 값이 (this * val) 로 스케일이 (this.scale() + val.scale()) 의 BigDecimal 를 돌려줍니다.
BigDecimal	negate () 값이 (-this) 로 스케일이 this.scale() 의 BigDecimal 를 돌려줍니다.
int	scale () 이 BigDecimal 의 「스케일」을 돌려줍니다.
BigDecimal	setScale (int scale) 스케일이 지정된 값이며, 값이 이 BigDecimal 과 동일한 BigDecimal 를 돌려줍니다.
BigDecimal	setScale (int scale, int roundingMode) 스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 BigDecimal 의 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 의 누승의 적 또는 상에 의해 결정되는 BigDecimal 를 돌려줍니다.
int	signum () 이 BigDecimal 의 부호치를 돌려줍니다.
BigDecimal	subtract (BigDecimal val) 값이 (this - val) 로 스케일이 max(this.scale(), val.scale()) 의 BigDecimal 를 돌려줍니다.
BigInteger	toBigInteger () 이 BigDecimal 를 BigInteger 로 변환합니다.
String	toString () 이 BigDecimal 의 String 표현을 돌려줍니다.
BigInteger	unscaledValue () 값이 이 BigDecimal 의 「스케일 없음의 값」인 BigDecimal 를 돌려줍니다 ((this * 10this.scale()) 를 계산한다).
static BigDecimal	valueOf (long val) long 치를 스케일이 0 의 BigDecimal 로 변환합니다.
static BigDecimal	valueOf (long unscaledVal, int scale) long 의 스케일 없음의 값과 int 스케일을 BigDecimal 로 변환합니다.

클래스 java.lang. Number 에서 상속받은 메소드

byteValue , shortValue

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

ROUND_UP

public static final int ROUND_UP

0 으로부터 멀어지도록(듯이) 마는 모드입니다. 파기되는 0 이외의 소수부에 선행하는 자리수를 항상 늘립니다. 이 둥근 모드는 계산된 값의 절대치를 줄이지 않습니다.

관련 항목:

정수 필드치

ROUND_DOWN

public static final int ROUND_DOWN

0 에 가까워지도록(듯이) 마는 모드입니다. 파기되는 소수부에 선행하는 자리수를 증분 하지 않습니다 (즉 잘라서 버림). 이 둥근 모드는 계산된 값의 절대치를 늘리지 않습니다.

관련 항목:

정수 필드치

ROUND_CEILING

public static final int ROUND_CEILING

정의 무한대에 가까워지도록(듯이) 마는 모드입니다. BigDecimal 가 정의 경우는 ROUND_UP 와 같이 동작해, 부의 경우는 ROUND_DOWN 와 같이 동작합니다. 이 둥근 모드는 계산된 값을 줄이지 않습니다.

관련 항목:

정수 필드치

ROUND_FLOOR

public static final int ROUND_FLOOR

부의 무한대에 가까워지도록(듯이) 마는 모드입니다. BigDecimal 이 정의 경우는 ROUND_DOWN 와 같이 동작해, 부의 경우는 ROUND_UP 와 같이 동작합니다. 이 둥근 모드는 계산된 값을 늘리지 않습니다.

관련 항목:

정수 필드치

ROUND_HALF_UP

public static final int ROUND_HALF_UP

「가장 가까운 숫자」에 마는 모드입니다. 다만, 양쪽이웃의 숫자가 등거리의 경우는 끝맺습니다. 파기되는 소수부가 . 5 이상의 경우는 ROUND_UP 와 같이 동작해, 그 이외의 경우는 ROUND_DOWN 와 같이 동작합니다. 이것은 우리의 대부분이 초등학교에서 배운 절상입니다.

관련 항목:

정수 필드치

ROUND_HALF_DOWN

public static final int ROUND_HALF_DOWN

「가장 가까운 숫자」에 마는 모드입니다. 다만, 양쪽이웃의 숫자가 등거리의 경우는 잘라 버립니다. 파기되는 소수부가 . 5 를 넘는 경우는 ROUND_UP 와 같이 동작해, 그 이외의 경우는 ROUND_DOWN 와 같이 동작합니다.

관련 항목:

정수 필드치

ROUND_HALF_EVEN

public static final int ROUND_HALF_EVEN

「가장 가까운 숫자」에 마는 모드입니다. 다만, 양쪽이웃의 숫자가 등거리의 경우는 짝수 측에 맙니다. 파기하는 소수부의 좌변의 자리수가 홀수의 경우는 ROUND_HALF_UP 와 같이 동작해, 짝수의 경우는 ROUND_HALF_DOWN 와 같이 동작합니다. 이 둥근 모드는 연속하는 계산으로 반복해 적용되는 경우에 누적 에러를 최소로 합니다.

관련 항목:

정수 필드치

ROUND_UNNECESSARY

public static final int ROUND_UNNECESSARY

요구되는 연산의 결과가 정확하고, 둥근이 필요하지 않은 것을 나타내는 둥근 모드입니다. 이 둥근 모드가 결과가 정확하지 않은 연산으로 지정되는 경우는 ArithmeticException 가 슬로우 됩니다.

관련 항목:

정수 필드치

생성자의 상세

BigDecimal

public BigDecimal(String  val)

BigDecimal 의 String 표현을 BigDecimal 로 변환합니다. String 표현은 임의의 부호 '+' ('\u002B') 또는 '-' ('\u002D')와 거기에 계속되는 0 이상의 10 진수자 ( 「정수부」)의 열로 구성되어 임의로 소수부 또는 지수가 부수 합니다.

소수부는 소수점과 0 이상의 10 진수자로 구성됩니다. 이 캐릭터 라인에서는 정수부 또는 소수부가 적어도 1 자리수는 필요합니다. 부호가 붙은 숫자는 정수부 및 소수부 모두 significand 로서 참조됩니다.

지수는 'e' ('\u0075') 또는 'E' ('\u0045')라고 하는 캐릭터로부터 구성되어 1 이상의 10 진수자가 계속됩니다. 지수치는 -Integer.MAX_VALUE (Integer.MIN_VALUE +1)로부터 Integer.MAX_VALUE 의 사이에 들어가고 있을 필요가 있습니다.

즉, 이 constructor 이 받아들이는 캐릭터 라인은 다음의 문법에 따라 기술됩니다.

BigDecimalString:

Sign_opt Significand Exponent_opt

Sign:

+

-

Significand:

IntegerPart . FractionPart_opt

. FractionPart

IntegerPart

IntegerPart:

Digits

FractionPart:

Digits

Exponent:

ExponentIndicator SignedInteger

ExponentIndicator:

e

E

SignedInteger:

Sign_opt Digits

Digits:

Digit

Digits Digit

Digit:

Character.isDigit(char) 가 true 를 돌려주는 임의의 캐릭터 (0, 1, 2 등)

돌려주어지는 BigDecimal 의 스케일은 소수점의 자리수 또는 캐릭터 라인에 소수점이 없는 경우는 제로가 되어, 지수를 조정합니다. 캐릭터 라인에 지수가 있는 경우, 스케일로부터 지수가 감산됩니다. 그 결과 스케일이 부가 되는 경우, 돌려주어지는 BigDecimal 의 스케일은 제로가 되어, 스케일 없음의 값은 10 의 누승의 적이 됩니다. 이 결과, BigDecimal 는 유효 숫자 × 10^지수 와 동일해집니다. (향후, 부의 스케일을 인정하도록(듯이) 이 사양이 수정되어 스케일의 제로화 및 스케일 없음의 값의 조정은 삭제될 예정입니다. )

캐릭터형으로부터 수치형에의 매핑은 Character.digit(char, int) 로 제공되어 기수 10 에의 변환으로 설정되어 있습니다. String 에는 부적절한 캐릭터 (공백등)를 포함할 수 없습니다.

주: 다른 float 및 double 의 NaN, 및 ±Infinity 의 값으로는 이 constructor 은 Float.toString(float) 및 Double.toString(double) . 그리고 돌려주어지는 값과 호환성이 있습니다. 이 방법은 float 또는 double 를 BigDecimal 로 변환하는 좋은 방법입니다. 그 이유는 BigDecimal(double) constructor 의 예측을 할 수 없어도 영향을 받지 않기 때문입니다.

주: 릴리스 1.3 이후에서는 선두의 플러스 기호 및 말미의 지수를 임의로 붙일 수가 있게 되었습니다.

파라미터:

val - BigDecimal 의 String 표현

예외:

NumberFormatException - val 는 BigDecimal 의 표현으로서는 무효이다

BigDecimal

public BigDecimal(double val)

double 를 BigDecimal 로 변환합니다. BigDecimal 의 스케일은 (10^scale * val) 가 정수인 최소의 값입니다.

주: 이 constructor 의 결과는 예상외일 가능성이 있습니다. new BigDecimal(. 1) 은 정확하게 . 1 으로 동일하다고 생각될지도 모릅니다만, 실제로는 . 1000000000000000055511151231257827021181583404541015625 가 됩니다. 이것은 . 1 을 double (또는 유한장 2 진소수)로서 정확하게 표현할 수 없기 때문입니다. 따라서, constructor로 건네져 있는 long 치는 정확하게 . 1 으로 동일한 것은 아닙니다.

한편, String 를 인수로 하는 constructor 은 예측 가능합니다. new BigDecimal(". 1") 은 「정확하게」 . 1 으로 동일해집니다. 그 때문에, 통상은 double 를 인수로 하는 constructor 대신에 String 를 인수로 하는 constructor를 사용하는 것을 추천합니다.

파라미터:

val - BigDecimal 로 변환하는 double 치

예외:

NumberFormatException - val 는 Double.NEGATIVE_INFINITY,Double.POSITIVE_INFINITY, 또는 Double.NaN 와 동일하다

BigDecimal

public BigDecimal(BigInteger  val)

BigInteger 을 BigDecimal 로 변환합니다. BigDecimal 의 스케일은 0 입니다.

파라미터:

val - BigDecimal 로 변환하는 BigInteger 치

BigDecimal

public BigDecimal(BigInteger  unscaledVal,
                  int scale)

BigInteger 의 스케일 없음의 값과 int 스케일을 BigDecimal 로 변환합니다. BigDecimal 의 값은 (unscaledVal/10^scale) 입니다.

파라미터:

unscaledVal - BigDecimal 의 스케일 없음의 값

scale - BigDecimal 의 스케일

예외:

NumberFormatException - 스케일이 부의 경우

메소드의 상세

valueOf

public static BigDecimal  valueOf(long unscaledVal,
                                 int scale)

long 의 스케일 없음의 값과 int 스케일을 BigDecimal 로 변환합니다. 이 static 메소드는 자주(잘) 사용되는 BigDecimal 를 재이용할 수 있게 하기 위해서, long 와 int 를 인수로 하는 constructor 대신에 제공됩니다.

파라미터:

unscaledVal - BigDecimal 의 스케일 없음의 값

scale - BigDecimal 의 스케일

반환값:

치가 (unscaledVal/10^scale) 의 BigDecimal

valueOf

public static BigDecimal  valueOf(long val)

long 치를 스케일이 0 의 BigDecimal 로 변환합니다. 이 static 메소드는 자주(잘) 사용되는 BigDecimal 를 재이용할 수 있게 하기 위해서, long 를 인수로 하는 constructor 대신에 제공됩니다.

파라미터:

val - BigDecimal 의 값

반환값:

치가 val 의 BigDecimal

add

public BigDecimal  add(BigDecimal  val)

값이 (this + val) 로 스케일이 max(this.scale(), val.scale()) 의 BigDecimal 를 돌려줍니다.

파라미터:

val - 이 BigDecimal 에 가산하는 값

반환값:

this + val

subtract

public BigDecimal  subtract(BigDecimal  val)

값이 (this - val) 로 스케일이 max(this.scale(), val.scale()) 의 BigDecimal 를 돌려줍니다.

파라미터:

val - 이 BigDecimal 로부터 감산하는 값

반환값:

this - val

multiply

public BigDecimal  multiply(BigDecimal  val)

값이 (this * val) 로 스케일이 (this.scale() + val.scale()) 의 BigDecimal 를 돌려줍니다.

파라미터:

val - 이 BigDecimal 로 곱셈하는 값

반환값:

this * val

divide

public BigDecimal  divide(BigDecimal  val,
                         int scale,
                         int roundingMode)

값이 (this / val) 로, 스케일이 지정된 것인 BigDecimal 를 돌려줍니다. 둥근을 실시해, 지정한 스케일로 결과를 생성할 필요가 있는 경우는 지정한 둥근 모드가 적용됩니다.

파라미터:

val - 이 BigDecimal 를 제산하는 값

scale - 돌려주어지는 BigDecimal 의 상의 스케일

roundingMode - 적용하는 둥근 모드

반환값:

this / val

예외:

ArithmeticException - val 가 0 인지 scale 가 부이든가, 혹은 roundingMode==ROUND_UNNECESSARY 로, 지정한 스케일이 제산의 결과를 정확하게 나타내기에는 충분하지 않은 경우

IllegalArgumentException - roundingMode 가 유효한 둥근 모드를 나타내지 않는 경우

관련 항목:

ROUND_UP , ROUND_DOWN , ROUND_CEILING , ROUND_FLOOR , ROUND_HALF_UP , ROUND_HALF_DOWN , ROUND_HALF_EVEN , ROUND_UNNECESSARY

divide

public BigDecimal  divide(BigDecimal  val,
                         int roundingMode)

값이 (this / val) 로 스케일이 this.scale() 인 BigDecimal 를 돌려줍니다. 둥근을 실시해, 특정의 스케일로 결과를 생성할 필요가 있는 경우는 지정된 둥근 모드가 적용됩니다.

파라미터:

val - 이 BigDecimal 를 제산하는 값

roundingMode - 적용하는 둥근 모드

반환값:

this / val

예외:

ArithmeticException - val==0 이든가, 혹은 roundingMode==ROUND_UNNECESSARY 로 this.scale() 가 제산의 결과를 정확하게 나타내기에는 충분하지 않은 경우

IllegalArgumentException - roundingMode 가 유효한 둥근 모드를 나타내지 않는 경우

관련 항목:

ROUND_UP , ROUND_DOWN , ROUND_CEILING , ROUND_FLOOR , ROUND_HALF_UP , ROUND_HALF_DOWN , ROUND_HALF_EVEN , ROUND_UNNECESSARY

abs

public BigDecimal  abs()

값이 이 BigDecimal 의 절대치로 스케일이 this.scale() 의 BigDecimal 를 돌려줍니다.

반환값:

abs(this)

negate

public BigDecimal  negate()

값이 (-this) 로 스케일이 this.scale() 의 BigDecimal 를 돌려줍니다.

반환값:

-this

signum

public int signum()

이 BigDecimal 의 부호치를 돌려줍니다.

반환값:

이 BigDecimal 가 부의 경우는 -1, 제로의 경우는 0, 정의 경우는 1

scale

public int scale()

이 BigDecimal 의 「스케일」을 돌려줍니다. 스케일이란, 소수점 이하의 자리수입니다.

반환값:

이 BigDecimal 의 스케일

unscaledValue

public BigInteger  unscaledValue()

값이 이 BigDecimal 의 「스케일 없음의 값」인 BigDecimal 를 돌려줍니다 ((this * 10^this.scale()) 를 계산한다).

반환값:

이 BigDecimal 의 스케일 없음의 값

도입된 버젼:

1.2

setScale

public BigDecimal  setScale(int scale,
                           int roundingMode)

스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 BigDecimal 의 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 의 누승의 적 또는 상에 의해 결정되는 BigDecimal 를 돌려줍니다. 스케일이 연산으로 줄여지는 경우, 스케일 없음의 값은 (거는 것이 아니라) 나눌 필요가 있어, 값이 바뀔 가능성이 있습니다. 이 경우, 지정한 둥근 모드가 제산에 적용됩니다.

파라미터:

scale - 돌려주어지는 BigDecimal 의 값의 스케일

roundingMode - 적용하는 둥근 모드

반환값:

스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 BigDecimal 의 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 의 누승의 적 또는 상에 의해 결정되는 BigDecimal

예외:

ArithmeticException - 스케일이 부이든가, 혹은 roundingMode==ROUND_UNNECESSARY 로, 지정된 슬캘링 연산으로 둥근이 필요한 경우

IllegalArgumentException - roundingMode 가 유효한 둥근 모드를 나타내지 않는 경우

관련 항목:

ROUND_UP , ROUND_DOWN , ROUND_CEILING , ROUND_FLOOR , ROUND_HALF_UP , ROUND_HALF_DOWN , ROUND_HALF_EVEN , ROUND_UNNECESSARY

setScale

public BigDecimal  setScale(int scale)

스케일이 지정된 값이며, 값이 이 BigDecimal 과 동일한 BigDecimal 를 돌려줍니다. 이것이 가능하지 않은 경우는 ArithmeticException 를 슬로우 합니다. 이 메소드는 스케일을 늘리는데 자주(잘) 사용되어 그 경우에는 지정된 스케일과 올바른 값의 BigDecimal 의 존재가 프로텍션됩니다. 정밀도를 잃을리가 없는 재슬캘링을 실시하는데 충분한 0 이 BigDecimal 의 소수부 (그 정수치에 있어서의 10 의 인수)의 마지막에 있는 것을 호출측이 인식하고 있는 경우에는 스케일을 줄이는데 사용할 수도 있습니다.

이 메소드는 setScale 의 2 개의 인수를 사용하는 버젼과 같은 결과를 돌려줍니다만, 둥근을 지정할 필요가 없는 경우에, 호출측은 지정하는 수고를 생략할 수가 있습니다.

파라미터:

scale - 돌려주어지는 BigDecimal 의 값의 스케일

반환값:

스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 BigDecimal 의 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 의 누승의 적 또는 상에 의해 결정되는 BigDecimal

예외:

ArithmeticException - 스케일이 부이든가, 혹은 지정한 스케일 연산으로 둥근이 필요한 경우

관련 항목:

setScale(int, int)

movePointLeft

public BigDecimal  movePointLeft(int n)

소수점을 n 형좌에 이동해 이것에 동일한 BigDecimal 를 돌려줍니다. n 가 부가 아닌 경우는 단지 스케일에 n 를 더합니다. n 가 부의 경우는 movePointRight(-n)에 동일해집니다 (돌려주어지는 BigDecimal 의 값은 (this * 10^-n), 스케일은 max(this.scale() +n, 0)).

파라미터:

n - 소수점을 왼쪽에 이동하는 자리수

반환값:

소수점을 n 형좌에 이동한, 이것에 동일한 BigDecimal

movePointRight

public BigDecimal  movePointRight(int n)

소수점이 지정된 자리수만 우측향에 이동시킵니다. 이 BigDecimal 의 스케일이 n 이상의 경우는 단지 스케일로부터 n 를 뺍니다. 그 이외의 경우는 스케일을 0 으로 설정해, 그 정수치에 10^{(n - this.scale)} 을 곱합니다. n 가 부의 경우는 movePointLeft(-n) 에 동일해집니다 (돌려주어지는 BigDecimal 의 값은 (this * 10ⁿ), 스케일은 max(this.scale() -n, 0)).

파라미터:

n - 소수점을 오른쪽에 이동하는 자리수

반환값:

소수점을 n 형우에 이동한, 이것에 동일한 BigDecimal

compareTo

public int compareTo(BigDecimal  val)

이 BigDecimal 과 지정된 BigDecimal 를 비교합니다. 값은 동일하지만 스케일이 다른 2 개의 BigDecimal (예를 들어, 2.0 으로 2.00)는 동일하다고 보여집니다. 이 메소드는 6 개의 boolean 형의 비교 연산자 (<,==, >, >=,! =, <=)의 각각 대하는 개개의 메소드 대신에 제공됩니다. 이러한 비교를 실시하려면 (x.compareTo(y) <op> 0) 라고 하는 편성을 추천합니다. 이 경우, <op> 에는 6 개의 연산자 가운데 1 개가 들어갑니다.

파라미터:

val - 이 BigDecimal 와 비교하는 BigDecimal

반환값:

이 BigDecimal 의 값이 val 보다 작은 경우는 -1, 동일한 경우는 0, 큰 경우는 1

compareTo

public int compareTo(Object  o)

이 BigDecimal 와 지정된 Object 를 비교합니다. Object 가 BigDecimal 의 경우, 이 메소드는 compareTo(java.math.BigDecimal) 와 같이 동작해, 그 이외의 경우는 ClassCastException 를 슬로우 합니다 (BigDecimal 은 다른 BigDecimal 로 밖에 비교할 수 없기 때문에).

정의:

인터페이스 Comparable 내의 compareTo

파라미터:

o - 이 BigDecimal 와 비교하는 Object

반환값:

이 BigDecimal 의 값이 o 보다 작은 경우는 부의 수, 동일한 경우는 0, 큰 경우는 정의 수. o 는 BigDecimal 가 아니면 안된다

예외:

ClassCastException - o 가 BigDecimal 가 아닌 경우

도입된 버젼:

1.2

관련 항목:

compareTo(java.math.BigDecimal) , Comparable

equals

public boolean equals(Object  x)

이 BigDecimal 와 지정된 Object 가 동일한지 어떤지를 비교합니다. compareTo(java.math.BigDecimal) 와 달라, 이 메소드는 2 개의 BigDecimal 가 값도 스케일도 같은 경우에만 동일하다고 봅니다 (따라, 이 메소드에서는 2.0 으로 2.00 은 동일하지 않다).

오버라이드(override):

클래스 Object 내의 equals

파라미터:

x - 이 BigDecimal 와 비교하는 Object

반환값:

지정한 Object 가 이 BigDecimal 과 값도 스케일도 동일한 BigDecimal 인 경우에만 true

관련 항목:

compareTo(java.math.BigDecimal)

min

public BigDecimal  min(BigDecimal  val)

이 BigDecimal 와 val 의 최소치를 돌려줍니다.

파라미터:

val - 최소치를 계산하는 값

반환값:

이 BigDecimal 과 val 가운데로 작은 (분)편의 값을 가지는 BigDecimal. compareTo(java.math.BigDecimal) 메소드로 정의되고 있는 비교 방법으로 값이 동일한 경우는 어느 쪽인지가가 돌려주어지는

관련 항목:

compareTo(java.math.BigDecimal)

max

public BigDecimal  max(BigDecimal  val)

이 BigDecimal 와 val 의 최대치를 돌려줍니다.

파라미터:

val - 최대치를 계산하는 값

반환값:

이 BigDecimal 과 val 가운데로 큰 (분)편의 값을 가지는 BigDecimal. compareTo(java.math.BigDecimal) 메소드로 정의되고 있는 비교 방법으로 값이 동일한 경우는 어느 쪽인지가가 돌려주어지는

관련 항목:

compareTo(java.math.BigDecimal)

hashCode

public int hashCode()

이 BigDecimal 의 해시 코드를 돌려줍니다. 값이 동일하지만 스케일이 다른 2 개의 BigDecimal (예를 들어, 2.0 으로 2.00)는 통상은 해시 코드가 다릅니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 BigDecimal 의 해시 코드

관련 항목:

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

toString

public String  toString()

이 BigDecimal 의 String 표현을 돌려줍니다. Character.forDigit(int, int) 에 의한 숫자로부터 캐릭터에의 매핑이 사용됩니다. 선행하는 마이너스 부호는 부호를 나타내기 위해서(때문에) 사용되어 소수점 이하의 자리수는 스케일을 나타내기 위해서(때문에) 사용됩니다 (이 표현은 String 를 인수로 하는 constructor 과 호환성이 있다).

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 BigDecimal 의 String 표현

관련 항목:

Character.forDigit(int, int) , BigDecimal(java.lang.String)

toBigInteger

public BigInteger  toBigInteger()

이 BigDecimal 를 BigInteger 로 변환합니다. 이것은 「Java 언어 사양」으로 정의되고 있는 표준의 「네로우 원시적 변환」입니다. 이 BigDecimal 의 소수부는 모두 파기됩니다.

반환값:

BigInteger 에 변환된 이 BigDecimal

intValue

public int intValue()

이 BigDecimal 를 int 로 변환합니다. 이것은 「Java 언어 사양」으로 정의되고 있는 표준의 「네로우 원시적 변환」입니다. 이 BigDecimal 의 소수부는 모두 파기되어 결과의 BigInteger 가 너무 커 int 에 적합하지 않는 경우는 하위의 32 비트만이 돌려주어집니다.

정의:

클래스 Number 내의 intValue

반환값:

int 에 변환된 이 BigDecimal

longValue

public long longValue()

이 BigDecimal 를 long 로 변환합니다. 이것은 「Java 언어 사양」으로 정의되고 있는 표준의 「네로우 원시적 변환」입니다. 이 BigDecimal 의 소수부는 모두 파기되어 결과의 BigInteger 가 너무 커 long 에 적합하지 않는 경우는 하위의 64 비트만이 돌려주어집니다.

정의:

클래스 Number 내의 longValue

반환값:

int 에 변환된 이 BigDecimal

floatValue

public float floatValue()

이 BigDecimal 를 float 로 변환합니다. 이것은 「Java 언어 사양」으로 정의되고 있는 double 로부터 float 에의 「네로우 원시적 변환」에 유사하고 있습니다. 이 BigDecimal 의 절대치가 너무 커 float 로서 나타낼 수가 없는 경우는 Float.NEGATIVE_INFINITY 또는 Float.POSITIVE_INFINITY 에 변환됩니다.

정의:

클래스 Number 내의 floatValue

반환값:

float 에 변환된 이 BigDecimal

doubleValue

public double doubleValue()

이 BigDecimal 를 double 로 변환합니다. 이것은 「Java 언어 사양」으로 정의되고 있는 double 로부터 float 에의 「네로우 원시적 변환」에 유사하고 있습니다. 이 BigDecimal 의 절대치가 너무 커 double 로서 나타낼 수가 없는 경우는 Double.NEGATIVE_INFINITY 또는 Double.POSITIVE_INFINITY 에 변환됩니다.

정의:

클래스 Number 내의 doubleValue

반환값:

double 에 변환된 이 BigDecimal