BigDecimal (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

전의 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.math
클래스 BigDecimal

java.lang.Object 
  java.lang.Number 
      java.math.BigDecimal

모든 구현된 인터페이스:: Serializable, Comparable <BigDecimal >

public class BigDecimal
extends Number
implements Comparable <BigDecimal >
extends Number
implements Comparable <BigDecimal >

변경이 불가능한, 임의 정밀도의 부호 첨부 소수입니다. BigDecimal는 임의 정밀도의 「스케일 없음의 정수값 」라고, 32 비트 정수의 「스케일」로 구성됩니다. 0 또는 정의 경우, 스케일은 소수점 아래의 자리수입니다. 부의 경우, 스케일 없음의 수치에 스케일의 정부를 반대로 한 값을 지수로 하는 10 누승을 곱셈합니다. 즉, BigDecimal로 나타내지는 수치는 (unscaledValue × 10^-scale) 입니다.

BigDecimal 클래스는 산술, 스케일 조작, 둥근, 비교, 핫싱 및 서식 변환의 연산을 제공합니다. toString() 메서드는 BigDecimal 정규 표현을 제공합니다.

BigDecimal 클래스는 사용자가 둥근 동작을 완전하게 제어할 수 있도록 합니다. 둥근 모드가 지정되지 않고, 정확한 결과를 표현할 수 없는 경우, 예외가 발생 됩니다. 그렇지 않은 경우, 연산에 적절한 MathContext 객체를 지정하는 것으로 선택된 정밀도와 둥근 모드로 계산이 실행됩니다. 어느 쪽의 경우도, 둥근 제어에 8개의 「둥근 모드」가 제공됩니다. 이 클래스의 정수 필드 (ROUND_HALF_UP 등)를 사용해 둥근 모드를 나타내는 것은 거의 행해지지 않습니다. RoundingMode enum (RoundingMode.HALF_UP 등)의 열거치를 사용해 주세요.

MathContext 객체에 정밀도 설정 0 (예: MathContext.UNLIMITED )이 가리키는 경우, 그 산술 메서드는 MathContext 객체를 사용하지 않기 때문에 산술 연산은 정확합니다. 이것은 릴리스 5 보다 전으로 지원 되고 있던 유일한 동작입니다. 결과의 계산이 정확하기 때문에 정밀도 0 설정을 가지는 MathContext 둥근 모드 설정은 사용되지 않고, 무관계합니다. 제산의 경우, 정확한 상은 소수점 이하가 무한의 길이를 가질 가능성이 있습니다 (예: 1 ÷ 3). 상의 소수점 이하가 무한해, 연산이 정확한 결과를 돌려주도록 가리키는 경우, ArithmeticException이 발생 됩니다. 그렇지 않은 경우, 다른 연산과 같게, 제산의 정확한 결과가 리턴됩니다 .

정밀도 설정이 0 이 아닌 경우, BigDecimal 산술 규칙은 ANSI X3. 274-1996 및 ANSI X3. 274-1996/AM 1-2000 (섹션 7.4)로 정의되고 있는 선택된 연산 모드와 광범위한 호환성이 있습니다. 이러한 규격과는 달라, BigDecimal에는 릴리스 5 보다 전의 BigDecimal 제산으로 필수였다 많은 둥근 모드가 있습니다. 이러한 ANSI 규격과 BigDecimal 사양의 경합은, BigDecimal를 우선하는 방법으로 해결됩니다.

같은 수치에서도 표현이 다를 (스케일이 다를) 가능성이 있기 때문에 산술 및 둥근 규칙은 수치적인 결과와 결과의 표현에 사용하는 스케일의 양쪽 모두를 지정할 필요가 있습니다.

일반적으로 정확한 결과에 리턴된 자리수보다 대부분 (제산의 경우는 무한대도)의 자리수 있는인 경우, 둥근 모드와 정밀도 설정에의해 연산이 돌려주는 결과의 자리수가 정해집니다. 우선, 리턴된 자리수의 합계수는 MathContext precision 설정으로 지정됩니다. 이것에 의해 결과의 「정밀도」가 결정됩니다. 자리수의 카운트는 정확한 결과의 가장 왼쪽의 0 이 아닌 자리수로부터 시작됩니다. 둥근 모드에서는 파기되는 자리수가 리턴된 결과에 어떻게 영향을 줄지가 결정됩니다.

모든 산술 연산자에서는 연산은 우선 정확한 중간 결과를 계산해, 다음에 선택된 둥근 모드를 사용해 (필요한 경우는) 정밀도 설정으로 지정된 자리수에 말다고 하는 순서로 실행됩니다. 정확한 결과가 돌려주고지지 않은 경우, 정확한 결과의 몇개의 자리수 위값이 파기됩니다. 둥근에의해 리턴된 결과의 절대값이 증가하는 경우, 선두의 「9」의 자리수에 대해서 자리수의 앞당기기를 실행하는 것으로 새로운 자리수 위치를 작성할 수 있습니다. 예를 들어 999.9 라고 하는 값을 절상해 3 자리수에 말면, 1000 으로 동일해져, 이것은 100×10¹ 으로서 표현됩니다. 이러한 경우, 새롭게 「1」이 리턴된 결과의 선두의 자리수 위값이 됩니다.

논리적으로 정확한 결과외, 각 산술 연산에는 결과를 표현하기 위해서 우선되는 스케일이 있습니다. 각 연산의 우선 스케일을 다음의 겉(표)에 나타냅니다.

산술 연산의 결과로 우선되는 스케일
연산	우선되는 결과의 스케일
가산	max(addend.scale(), augend.scale())
감산	max(minuend.scale(), subtrahend.scale())
곱셈	multiplier.scale() + multiplicand.scale()
제산	dividend.scale() - divisor.scale()

이러한 스케일은 정확한 산술 결과를 돌려주는 메서드 에 해서만 사용됩니다. 다만, 정확한 제산에서는 정확한 결과의 자리수가 많을 가능성이 있기 때문에 보다 큰 스케일을 사용할 필요가 있는 경우가 있습니다. 예를 들어, 1/32는 0.03125 입니다.

둥근 전은 논리적으로 정확한 중간 결과의 스케일이 그 연산의 우선 스케일입니다. 정확한 수치 결과를 precision 자리수로 표현할 수 없는 경우, 둥근에 의해 돌려주는 자리수 세트가 선택되어 그 결과의 스케일은 중간 결과의 스케일로부터, 실제로 리턴된 precision 자리수를 나타낼 수 있는 최소의 스케일에 축소됩니다. 정확한 결과가 precision 자리수로 표현할 수 있는 경우, 그 결과의 표현은 우선 스케일에 가장 가까운 스케일로 리턴됩니다 . 특히, 정확하게 표현 가능한 상은 후속의 0 으로 삭제해, 스케일을 작게 하는 것으로precision 자리수보다 적은 자리수로 표현할 수 있습니다. 예를 들어, floor 둥근 모드를 사용한 3 자리수에의 둥근에서는
19/100 = 0.19 // integer=19, scale=2
됩니다만, 다음도 성립됩니다.
21/110 = 0.190 // integer=190, scale=3

가산, 감산 및 곱셈에서는 스케일의 축소는 정확한 결과의 파기되는 자리수 위치의 수로 동일해지는 점에 주의해 주세요. 둥근에 한 자리수의 앞당기기로 새로운 상위의 자리수 위값이 작성되는 경우, 새로운 자리수 위값이 작성되지 않으면 결과의 추가된 자리수는 파기됩니다.

다른 메서드는 조금 다른 둥근 시멘틱스를 가질 가능성이 있습니다. 예를 들어, 지정된 알고리즘을 사용하는 pow 메서드의 결과는 말 수 있었던 수학적 결과와 1 ulp 이상 다른 경우가 있습니다.

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

설명을 알기 쉽고 간결하게 하기 위해서 BigDecimal 메서드의 설명에서는 전체를 통해 사 코드를 사용합니다. 사 코드식 (i + j) 은 「값이 BigDecimal i 값과 BigDecimal j 값의 화인 BigDecimal」를 나타냅니다. 사 코드식 (i == j) 은 「BigDecimal i가 BigDecimal j와 같은 값을 나타내는 경우에만 true 인 것」을 나타냅니다. 다른 사 코드식도 똑같이 해석됩니다. 꺽쇄묶음은, BigDecimal 치를 정의하는 특별한 BigInteger와 스케일의 페어를 나타내기 위해서 사용됩니다. 예를 들어,[19, 2]는 스케일 2를 가지는 0.19 로 수치적으로 동일한 BigDecimal 입니다.

주: BigDecimal 객체를 SortedMap 키 또는 SortedSet 요소로서 사용하는 경우는 주의해 주세요. BigDecimal 「자연 정렬」가 「equals와 모순된다」로부터입니다. 자세한 내용은 Comparable, SortedMap, 또는 SortedSet를 참조하십시오.

이 클래스의 메서드 및 생성자는 모두, 입력 파라미터에 대해서 null 객체 참조가 건네받으면 NullPointerException을 Throw 합니다.

관련 항목:: BigInteger, MathContext, RoundingMode, SortedMap, SortedSet, 직렬화 된 형식

필드 개요
`static BigDecimal`	`ONE` 스케일 0 값 1 입니다.
`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 로부터 멀어지도록 마는 모드입니다.
`static BigDecimal`	`TEN` 스케일 0 값 10 입니다.
`static BigDecimal`	`ZERO` 스케일 0 값 0 입니다.

생성자 개요
`BigDecimal (BigInteger val)` `BigInteger`을 `BigDecimal`로 변환합니다.
`BigDecimal (BigInteger unscaledVal, int scale)` `BigInteger` 스케일 없음의 값과 `int` 스케일을 `BigDecimal`로 변환합니다.
`BigDecimal (BigInteger unscaledVal, int scale, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, `BigInteger` 스케일 없음의 값과 `int` 스케일을 `BigDecimal`로 변환합니다.
`BigDecimal (BigInteger val, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해 `BigInteger`을 `BigDecimal`로 변환합니다.
`BigDecimal (char[] in)` `BigDecimal` 문자 배열 표현을 `BigDecimal`로 변환해, 같은 문자 순서를 `BigDecimal(String)` 생성자 으로서 받습니다.
`BigDecimal (char[] in, int offset, int len)` `BigDecimal` 문자 배열 표현을 `BigDecimal`로 변환해, 같은 문자 순서를 `BigDecimal(String)` 생성자 으로서 받아, 부분 배열의 지정을 가능하게 합니다.
`BigDecimal (char[] in, int offset, int len, MathContext mc)` 부분 배열의 지정을 가능하게 해, 컨텍스트 설정에 따른 둥근을 사용하면서, `BigDecimal` 문자 배열 표현을 `BigDecimal`로 변환해, 같은 문자 순서를 `BigDecimal(String)` 생성자 으로서 받습니다.
`BigDecimal (char[] in, MathContext mc)` `BigDecimal` 문자 배열 표현을 `BigDecimal`로 변환해, 컨텍스트 설정에 따른 둥근을 사용해, 같은 문자 순서를 `BigDecimal(String)` 생성자 으로서 받습니다.
`BigDecimal (double val)` `double`를 `double` 바이너리 부동 소수점치의 정확한 10 진수 표현인 `BigDecimal`로 변환합니다.
`BigDecimal (double val, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, `double`를 `BigDecimal`로 변환합니다.
`BigDecimal (int val)` `int`를 `BigDecimal`로 변환합니다.
`BigDecimal (int val, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해 `int`를 `BigDecimal`로 변환합니다.
`BigDecimal (long val)` `long`를 `BigDecimal`로 변환합니다.
`BigDecimal (long val, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해 `long`를 `BigDecimal`로 변환합니다.
`BigDecimal (String val)` `BigDecimal`의 캐릭터 라인 표현을 `BigDecimal`로 변환합니다.
`BigDecimal (String val, MathContext mc)` `BigDecimal` 캐릭터 라인 표현을 `BigDecimal`로 변환해, 컨텍스트 설정에 따른 둥근을 사용해, 같은 캐릭터 라인을 `BigDecimal(String)` 생성자 으로서 받습니다.

메서드 개요
`BigDecimal`	`abs ()` 값이 이 `BigDecimal` 절대치로 스케일이 `this.scale()` `BigDecimal`를 리턴합니다.
`BigDecimal`	`abs (MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 이 `BigDecimal` 절대치인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`add (BigDecimal augend)` 값이 `(this + augend)`로 스케일이 `max(this.scale(), augend.scale())` `BigDecimal`를 리턴합니다.
`BigDecimal`	`add (BigDecimal augend, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(this + augend)` 인 `BigDecimal`를 리턴합니다.
`byte`	`byteValueExact ()` 이 `BigDecimal`를 `byte`로 변환해, 없어진 정보가 있는지 없는지를 확인합니다.
`int`	`compareTo (BigDecimal val)` 이 `BigDecimal` 과 지정된 `BigDecimal`를 비교합니다.
`BigDecimal`	`divide (BigDecimal divisor)` 값이 `(this / divisor)`로 우선 스케일이 `(this.scale() - divisor.scale())` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`divide (BigDecimal divisor, int roundingMode)` 값이 `(this / divisor)`로 스케일이 `this.scale()` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`divide (BigDecimal divisor, int scale, int roundingMode)` 값이 `(this / divisor)`로 스케일이 지정된 것인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`divide (BigDecimal divisor, int scale, RoundingMode roundingMode)` 값이 `(this / divisor)`로 스케일이 지정된 것인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`divide (BigDecimal divisor, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(this / divisor)` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`divide (BigDecimal divisor, RoundingMode roundingMode)` 값이 `(this / divisor)`로 스케일이 `this.scale()` 인 `BigDecimal`를 리턴합니다.
`BigDecimal []`	`divideAndRemainder (BigDecimal divisor)` `divideToIntegralValue` 결과와 거기에 계속되는 2개의 오퍼랜드의 `remainder` 결과를 포함한, 2 요소의 `BigDecimal` 배열을 리턴합니다.
`BigDecimal []`	`divideAndRemainder (BigDecimal divisor, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해 계산된 `divideToIntegralValue` 결과와 2개의 오퍼랜드의 `remainder` 결과를 포함한, 2 요소의 `BigDecimal` 배열을 리턴합니다.
`BigDecimal`	`divideToIntegralValue (BigDecimal divisor)` 값을 말 수 있었던 상 `(this / divisor)` 정수부인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`divideToIntegralValue (BigDecimal divisor, MathContext mc)` 값이 `(this / divisor)` 정수부인 `BigDecimal`를 리턴합니다.
`double`	`doubleValue ()` 이 `BigDecimal`를 `double`로 변환합니다.
`boolean`	`equals (Object x)` 이 `BigDecimal`와 지정된 `Object`가 동일한지 어떤지를 비교합니다.
`float`	`floatValue ()` 이 `BigDecimal`를 `float`로 변환합니다.
`int`	`hashCode ()` 이 `BigDecimal` 해시 코드를 리턴합니다.
`int`	`intValue ()` 이 `BigDecimal`를 `int`로 변환합니다.
`int`	`intValueExact ()` 이 `BigDecimal`를 `int`로 변환해, 없어진 정보가 있는지 없는지를 확인합니다.
`long`	`longValue ()` 이 `BigDecimal`를 `long`로 변환합니다.
`long`	`longValueExact ()` 이 `BigDecimal`를 `long`로 변환해, 없어진 정보가 있는지 없는지를 확인합니다.
`BigDecimal`	`max (BigDecimal val)` 이 `BigDecimal`와 `val` 최대값을 리턴합니다.
`BigDecimal`	`min (BigDecimal val)` 이 `BigDecimal`와 `val` 최소값을 리턴합니다.
`BigDecimal`	`movePointLeft (int n)` 소수점을 `n` 형좌에 이동해 이것에 동일한 `BigDecimal`를 리턴합니다.
`BigDecimal`	`movePointRight (int n)` 소수점을 `n` 형우에 이동해 이것에 동일한 `BigDecimal`를 리턴합니다.
`BigDecimal`	`multiply (BigDecimal multiplicand)` 값이 `(this × multiplicand)`로 스케일이 `(this.scale() + multiplicand.scale())` `BigDecimal`를 리턴합니다.
`BigDecimal`	`multiply (BigDecimal multiplicand, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(this × multiplicand)` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`negate ()` 값이 `(-this)`로 스케일이 `this.scale()` `BigDecimal`를 리턴합니다.
`BigDecimal`	`negate (MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(-this)` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`plus ()` 값이 `(+this)`로 스케일이 `this.scale()` `BigDecimal`를 리턴합니다.
`BigDecimal`	`plus (MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(+this)` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`pow (int n)` 값이 `(thisⁿ)` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`pow (int n, MathContext mc)` 값이 `(thisⁿ)` 인 `BigDecimal`를 리턴합니다.
`int`	`precision ()` 이 `BigDecimal` 「정밀도」를 리턴합니다.
`BigDecimal`	`remainder (BigDecimal divisor)` 값이 `(this % divisor)` `BigDecimal`를 리턴합니다.
`BigDecimal`	`remainder (BigDecimal divisor, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(this % divisor)` 인 `BigDecimal`를 리턴합니다.
`BigDecimal`	`round (MathContext mc)` `MathContext` 설정에 따라 말 수 있었던 `BigDecimal`를 리턴합니다.
`int`	`scale ()` 이 `BigDecimal` 「스케일」을 리턴합니다.
`BigDecimal`	`scaleByPowerOfTen (int n)` 수값이 (`this` * 10ⁿ)에 동일한 BigDecimal를 리턴합니다.
`BigDecimal`	`setScale (int newScale)` 스케일이 지정된 값이며, 값이 이 `BigDecimal` 과 같은 수치인, `BigDecimal`를 리턴합니다.
`BigDecimal`	`setScale (int newScale, int roundingMode)` 스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 `BigDecimal` 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 누승의 적 또는 상에 의해 결정되는 `BigDecimal`를 리턴합니다.
`BigDecimal`	`setScale (int newScale, RoundingMode roundingMode)` 스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 `BigDecimal` 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 누승의 적 또는 상에 의해 결정되는 `BigDecimal`를 리턴합니다.
`short`	`shortValueExact ()` 이 `BigDecimal`를 `short`로 변환해, 없어진 정보가 있는지 없는지를 확인합니다.
`int`	`signum ()` 이 `BigDecimal` 부호치를 리턴합니다.
`BigDecimal`	`stripTrailingZeros ()` 수치는 이것에 동일하지만, 후속의 0 이 표현으로부터 삭제된 `BigDecimal`를 리턴합니다.
`BigDecimal`	`subtract (BigDecimal subtrahend)` 값이 `(this - subtrahend)`로 스케일이 `max(this.scale(), subtrahend.scale())` `BigDecimal`를 리턴합니다.
`BigDecimal`	`subtract (BigDecimal subtrahend, MathContext mc)` 컨텍스트 설정에 따른 둥근을 사용해, 값이 `(this - subtrahend)` 인 `BigDecimal`를 리턴합니다.
`BigInteger`	`toBigInteger ()` 이 `BigDecimal`를 `BigInteger`로 변환합니다.
`BigInteger`	`toBigIntegerExact ()` 이 `BigDecimal`를 `BigInteger`로 변환해, 없어진 정보가 있는지 없는지를 확인합니다.
`String`	`toEngineeringString ()` 지수가 필요한 경우, 기술 표기법으로 이 `BigDecimal` 캐릭터 라인 표현을 리턴합니다.
`String`	`toPlainString ()` 지수 필드없이, 이 `BigDecimal` 캐릭터 라인 표현을 리턴합니다.
`String`	`toString ()` 지수가 필요한 경우, 과학 표기법으로 이 `BigDecimal` 캐릭터 라인 표현을 리턴합니다.
`BigDecimal`	`ulp ()` 이 `BigDecimal` ulp (최종자리수 단위)의 사이즈를 리턴합니다.
`BigInteger`	`unscaledValue ()` 값이 이 `BigDecimal` 「스케일 없음의 값」인 `BigInteger`를 리턴합니다 (`(this * 10^this.scale())`를 계산한다).
`static BigDecimal`	`valueOf (double val)` `Double.toString(double)` 메서드에 의해 제공되는 `double` 표준적인 캐릭터 라인 표현을 사용해, `double`를 `BigDecimal`로 변환합니다.
`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`

필드의 상세

ZERO

public static final BigDecimal  ZERO

스케일 0 값 0 입니다.

도입된 버전 :: 1.5

ONE

public static final BigDecimal  ONE

스케일 0 값 1 입니다.

도입된 버전 :: 1.5

TEN

public static final BigDecimal  TEN

스케일 0 값 10 입니다.

도입된 버전 :: 1.5

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

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

관련 항목:: 정수 필드값

ROUND_HALF_DOWN

public static final int ROUND_HALF_DOWN

「가장 가까운 숫자」에 마는 모드입니다. 다만, 양쪽이웃의 숫자가 등거리의 경우는 잘라 버립니다. 파기되는 소수부가 0.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(char[] in,
                  int offset,
                  int len)

BigDecimal 문자 배열 표현을 BigDecimal로 변환해, 같은 문자 순서를 BigDecimal(String) 생성자 으로서 받아, 부분 배열의 지정을 가능하게 합니다.

문자 순서가 문자 배열내에서 이미 사용 가능한 경우, char 배열을 캐릭터 라인으로 변환해 BigDecimal(String) 생성자를 사용하는 것보다도, 이 생성자를 사용한 (분)편이 고속으로.

파라미터:: in - 캐릭터 라인의 근원이 되는 char 배열; offset - 조사하는 배열의 최초의 문자; len - 검토하는 문자수
예외:: NumberFormatException - in가 BigDecimal 유효한 표현이 아닌 경우, 또는 정의된 부분 배열이 완전하게 in 내에 없는 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(char[] in,
                  int offset,
                  int len,
                  MathContext  mc)

부분 배열의 지정을 가능하게 해, 컨텍스트 설정에 따른 둥근을 사용하면서, BigDecimal 문자 배열 표현을 BigDecimal로 변환해, 같은 문자 순서를 BigDecimal(String) 생성자 으로서 받습니다.

문자 순서가 문자 배열내에서 이미 사용 가능한 경우, char 배열을 캐릭터 라인으로 변환해, BigDecimal(String) 생성자를 사용하는 것보다도, 이 생성자를 사용한 (분)편이 고속으로.

파라미터:: in - 문자의 소스인 char 배열; offset - 조사하는 배열의 최초의 문자; len - 검토하는 문자수; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우; NumberFormatException - in가 BigDecimal 유효한 표현이 아닌 경우, 또는 정의된 부분 배열이 완전하게 in 내에 없는 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(char[] in)

BigDecimal 문자 배열 표현을 BigDecimal로 변환해, 같은 문자 순서를 BigDecimal(String) 생성자 으로서 받습니다.

문자 순서가 문자 배열로서 이미 사용 가능한 경우, char 배열을 캐릭터 라인으로 변환해 BigDecimal(String) 생성자를 사용하는 것보다도, 이 생성자를 사용한 (분)편이 고속으로.

파라미터:: in - 문자의 소스인 char 배열
예외:: NumberFormatException - in가 BigDecimal 유효한 표현이 아닌 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(char[] in,
                  MathContext  mc)

BigDecimal 문자 배열 표현을 BigDecimal로 변환해, 컨텍스트 설정에 따른 둥근을 사용해, 같은 문자 순서를 BigDecimal(String) 생성자 으로서 받습니다.

파라미터:: in - 문자의 소스인 char 배열; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우; NumberFormatException - in가 BigDecimal 유효한 표현이 아닌 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(String  val)

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

소수부는 소수점과 0 자리수 이상의 10 진수자로 구성됩니다. 이 캐릭터 라인에서는 정수부 또는 소수부가 적어도 1 자리수는 필요합니다. 부호, 정수부, 소수부로부터 되는 숫자는 「유효 숫자」라고 불립니다.

지수는 「e」( 「\u0075」) 또는 「E」( 「\u0045」)이라고 하는 문자에 1개 이상의 10 진수자가 계속되는 형태로 구성됩니다. 지수치는 -Integer.MAX_VALUE (Integer.MIN_VALUE +1)로부터 Integer.MAX_VALUE 범위의 값이 아니면 안됩니다.

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 스케일은 소수부의 자리수 또는 0 (캐릭터 라인에 소수부가 없는 경우)이 되어, 지수를 조정합니다. 캐릭터 라인에 지수 있는인 경우, 스케일로부터 지수가 감산됩니다. 결과의 스케일치는 Integer.MIN_VALUE로 부터 Integer.MAX_VALUE 범위의 값이 아니면 안됩니다.

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

례:
리턴된 BigDecimal 값은 「유효 숫자」× 10^exponent와 동일해집니다. 좌측으로 각 캐릭터 라인, 우측으로 결과의 표현 [BigInteger, scale]가 나타납니다.


 "0"            [0,0]
 "0.00"         [0,2]
 "123"          [123,0]
 "-123"         [-123, 0]
 "1.23E3"       [123,-1]
 "1.23E+3"      [123,-1]
 "12.3E+7"      [123,-6]
 "12.0"         [120,1]
 "12.3"         [123,1]
 "0.00123"      [123,5]
 "-1. 23E-12"    [-123, 14]
 "1234.5E-4"    [12345,5]
 "0E+7"         [0,-7]
 "-0"           [0,0]

주: float 및 double NaN 및 ±Infinity 이외의 값으로는 이 생성자는 Float.toString(float) 및 Double.toString(double) 로 리턴된 값과 호환성이 있습니다. 이 방법에서는 BigDecimal(double) 생성자 으로 예측을 할 수 없는 것에 밤영향을 받지 않기 때문에 float 또는 double를 BigDecimal 로 변환하는 바람직한 방법입니다.

파라미터:: val - BigDecimal 캐릭터 라인 표현
예외:: NumberFormatException - val가 BigDecimal 유효한 표현이 아닌 경우

BigDecimal

public BigDecimal(String  val,
                  MathContext  mc)

BigDecimal 캐릭터 라인 표현을 BigDecimal로 변환해, 컨텍스트 설정에 따른 둥근을 사용해, 같은 캐릭터 라인을 BigDecimal(String) 생성자 으로서 받습니다.

파라미터:: val - BigDecimal 캐릭터 라인 표현; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우; NumberFormatException - val가 BigDecimal 표현으로서 무효인 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(double val)

double를 double 바이너리 부동 소수점치의 정확한 10 진수 표현인 BigDecimal로 변환합니다. 리턴된 BigDecimal 스케일은, (10^scale × val)가 정수가 되는 것 같은 최소값입니다.

주:

이 생성자 결과는 예상외일 가능성이 있다. Java 로 new BigDecimal(0.1) 라고 기술하면, 0.1 으로 정확하게 동일한 BigDecimal (스케일 1, 스케일 없음의 값 1)가 작성된다고 생각할지도 모르지만, 실제로는 0.1000000000000000055511151231257827021181583404541015625 로 동일해진다. 이것은 0.1을 double (또는 어떤 유한장 2 진소수에서도)로서 정확하게 표현할 수 없기 때문이다. 따라서, 생성자에게 건네지는 값은 정확하게 0.1 으로 동일한 것은 아니다
한편, String 생성자는 완전하게 예측 가능하다. new BigDecimal("0.1") 라고 기술하면, 「정확하게」 0.1 으로 동일한 BigDecimal가 작성된다. 그 때문에 일반적으로 이것 대신에 String 생성자 을 사용하는 것이 추천 되고 있다
BigDecimal 소스로서 double를 사용할 필요가 있는 경우, 이 생성자는 정확한 변환을 실시하는 것에 주의할 필요가 있다. 이 생성자에서는 Double.toString(double) 메서드와 BigDecimal(String) 생성자를 사용해 double를 String로 변환했을 때와 같은 결과는 되지 않는다. 같은 결과를 얻으려면, static valueOf(double) 메서드를 사용한다

파라미터:: val - BigDecimal로 변환하는 double 치
예외:: NumberFormatException - val가 무한한가 NaN 인 경우

BigDecimal

public BigDecimal(double val,
                  MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, double를 BigDecimal로 변환합니다. BigDecimal 스케일은, (10^scale × val)가 정수인 것 같은 최소값입니다.

이 생성자 결과는 예상외일 가능성이 있기 때문에 일반적으로 사용은 추천하지 않습니다. BigDecimal(double) 생성자 주를 참조하십시오.

파라미터:: val - BigDecimal로 변환하는 double 치; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않게 RoundingMode가 UNNECESSARY인 경우; NumberFormatException - val가 무한한가 NaN 인 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(BigInteger  val)

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

파라미터:: val - BigDecimal로 변환하는 BigInteger 치

BigDecimal

public BigDecimal(BigInteger  val,
                  MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해 BigInteger을 BigDecimal로 변환합니다. BigDecimal 스케일은 0 입니다.

파라미터:: val - BigDecimal로 변환하는 BigInteger 치; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(BigInteger  unscaledVal,
                  int scale)

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

파라미터:: unscaledVal - BigDecimal 스케일 없음의 값; scale - BigDecimal 스케일

BigDecimal

public BigDecimal(BigInteger  unscaledVal,
                  int scale,
                  MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, BigInteger 스케일 없음의 값과 int 스케일을 BigDecimal로 변환합니다. BigDecimal의 값은 (unscaledVal × 10^-scale) 이어, precision와 둥근 모드 설정에 따라 말 수 있습니다.

파라미터:: unscaledVal - BigDecimal 스케일 없음의 값; scale - BigDecimal 스케일; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(int val)

int를 BigDecimal로 변환합니다. BigDecimal 스케일은 0 입니다.

파라미터:: val - BigDecimal로 변환하는 int 치
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(int val,
                  MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해 int를 BigDecimal로 변환합니다. 둥근을 실시하기 전의 BigDecimal 스케일은 0 입니다.

파라미터:: val - BigDecimal로 변환하는 int 치; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(long val)

long를 BigDecimal로 변환합니다. BigDecimal 스케일은 0 입니다.

파라미터:: val - BigDecimal로 변환하는 long 치
도입된 버전 :: 1.5

BigDecimal

public BigDecimal(long val,
                  MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해 long를 BigDecimal로 변환합니다. 둥근을 실시하기 전의 BigDecimal 스케일은 0 입니다.

파라미터:: val - BigDecimal로 변환하는 long 치; mc - 사용하는 컨텍스트
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

메서드의 상세

valueOf

public static BigDecimal  valueOf(long unscaledVal,
                                 int scale)

long 스케일 없음의 값과 int 스케일을 BigDecimal로 변환합니다. 이 「static 팩토리 메서드」는 자주 사용되는 BigDecimal 치의 재이용을 가능하게 하기 위한, (long, int) 생성자 보다 우선해 제공됩니다.

파라미터:: unscaledVal - BigDecimal 스케일 없음의 값; scale - BigDecimal 스케일
반환값:: 값이 (unscaledVal × 10^-scale) BigDecimal

valueOf

public static BigDecimal  valueOf(long val)

long 치를 스케일이 0 BigDecimal로 변환합니다. 이 「static 팩토리 메서드」는 자주 사용되는 BigDecimal 재이용을 가능하게 하기 위한, (long) 생성자 보다 우선해 제공됩니다.

파라미터:: val - BigDecimal 값
반환값:: 값이 val BigDecimal

valueOf

public static BigDecimal  valueOf(double val)

Double.toString(double) 메서드에 의해 제공되는 double 표준적인 캐릭터 라인 표현을 사용해, double를 BigDecimal로 변환합니다.

주: 이것은, double (또는 float)를 BigDecimal로 변환하기 위한 추천 되는 방법입니다. 리턴된 값은, Double.toString(double)를 사용했을 경우의 결과로부터 BigDecimal를 구축한 결과와 동일하기 때문입니다.

파라미터:: val - BigDecimal로 변환하는 double
반환값:: 값이 val와 동일한, 또는 대충 같은 BigDecimal
예외:: NumberFormatException - val가 무한한가 NaN 인 경우
도입된 버전 :: 1.5

add

public BigDecimal  add(BigDecimal  augend)

값이 (this + augend)로 스케일이 max(this.scale(), augend.scale()) BigDecimal를 리턴합니다.

파라미터:: augend - 이 BigDecimal에 가산하는 값
반환값:: this + augend

add

public BigDecimal  add(BigDecimal  augend,
                      MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (this + augend) 인 BigDecimal를 리턴합니다. 어느 쪽인가의 수값이 0 으로 정밀도 설정이 0 이외인 경우, 필요에 따라서 말 수 있던 것 외의 수값이 결과적으로 사용됩니다.

파라미터:: augend - 이 BigDecimal에 가산하는 값; mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 this + augend
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

subtract

public BigDecimal  subtract(BigDecimal  subtrahend)

값이 (this - subtrahend)로 스케일이 max(this.scale(), subtrahend.scale()) BigDecimal를 리턴합니다.

파라미터:: subtrahend - 이 BigDecimal로 부터 감산하는 값
반환값:: this - subtrahend

subtract

public BigDecimal  subtract(BigDecimal  subtrahend,
                           MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (this - subtrahend) 인 BigDecimal를 리턴합니다. subtrahend가 0 인 경우, 필요에 따라서 말 수 있었던 this 값이 결과적으로 사용됩니다. this가 0 인 경우, 결과는 subtrahend.negate(mc) 입니다.

파라미터:: subtrahend - 이 BigDecimal로 부터 감산하는 값; mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 this - subtrahend
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

multiply

public BigDecimal  multiply(BigDecimal  multiplicand)

값이 (this × multiplicand)로 스케일이 (this.scale() + multiplicand.scale()) BigDecimal를 리턴합니다.

파라미터:: multiplicand - 이 BigDecimal로 곱셈하는 값
반환값:: this * multiplicand

multiply

public BigDecimal  multiply(BigDecimal  multiplicand,
                           MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (this × multiplicand) 인 BigDecimal를 리턴합니다.

파라미터:: multiplicand - 이 BigDecimal로 곱셈하는 값; mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 this * multiplicand
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

divide

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

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

이 유산 메서드보다, 새로운 divide(BigDecimal, int, RoundingMode) 메서드를 사용해 주세요.

파라미터:: divisor - 이 BigDecimal를 제산하는 값; scale - 리턴된 BigDecimal 상의 스케일; roundingMode - 적용하는 둥근 모드
반환값:: this / divisor
예외:: ArithmeticException - divisor가 0 으로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  divisor,
                         int scale,
                         RoundingMode  roundingMode)

파라미터:: divisor - 이 BigDecimal를 제산하는 값; scale - 리턴된 BigDecimal 상의 스케일; roundingMode - 적용하는 둥근 모드
반환값:: this / divisor
예외:: ArithmeticException - divisor가 0 으로roundingMode==RoundingMode.UNNECESSARY 이며, 지정한 스케일이 제산의 결과를 정확하게 나타내기에는 충분하지 않은 경우
도입된 버전 :: 1.5

divide

public BigDecimal  divide(BigDecimal  divisor,
                         int roundingMode)

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

이 유산 메서드보다, 새로운 divide(BigDecimal, RoundingMode) 메서드를 사용해 주세요.

파라미터:: divisor - 이 BigDecimal를 제산하는 값; roundingMode - 적용하는 둥근 모드
반환값:: this / divisor
예외:: ArithmeticException - divisor==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

divide

public BigDecimal  divide(BigDecimal  divisor,
                         RoundingMode  roundingMode)

파라미터:: divisor - 이 BigDecimal를 제산하는 값; roundingMode - 적용하는 둥근 모드
반환값:: this / divisor
예외:: ArithmeticException - divisor==0 인지, 또는 roundingMode==RoundingMode.UNNECESSARY 이며, this.scale()가 제산의 결과를 정확하게 나타내기에는 충분하지 않은 경우

divide

public BigDecimal  divide(BigDecimal  divisor)

값이 (this / divisor)로 우선 스케일이 (this.scale() - divisor.scale()) 인 BigDecimal를 리턴합니다. (소수점 이하가 무한이 되기 때문에) 정확한 상을 표현할 수 없는 경우, ArithmeticException이 발생 됩니다.

파라미터:: divisor - 이 BigDecimal를 제산하는 값
반환값:: this / divisor
예외:: ArithmeticException - 정확한 상의 소수점 이하가 무한한 경우
도입된 버전 :: 1.5

divide

public BigDecimal  divide(BigDecimal  divisor,
                         MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (this / divisor) 인 BigDecimal를 리턴합니다.

파라미터:: divisor - 이 BigDecimal를 제산하는 값; mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 this / divisor
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY 또는 mc.precision == 0 으로 상의 소수점 이하가 무한의 경우
도입된 버전 :: 1.5

divideToIntegralValue

public BigDecimal  divideToIntegralValue(BigDecimal  divisor)

값을 말 수 있었던 상 (this / divisor) 정수부인 BigDecimal를 리턴합니다. 결과의 우선 스케일은 (this.scale() - divisor.scale()) 입니다.

파라미터:: divisor - 이 BigDecimal를 제산하는 값
반환값:: this / divisor 정수부
예외:: ArithmeticException - divisor==0 인 경우
도입된 버전 :: 1.5

divideToIntegralValue

public BigDecimal  divideToIntegralValue(BigDecimal  divisor,
                                        MathContext  mc)

값이 (this / divisor) 정수부인 BigDecimal를 리턴합니다. 정확한 상의 정수부는 둥근 모드에 존하지 않기 때문에 둥근 모드는 이 메서드에 의해 리턴된 값에 영향을 미치지 않습니다. 결과의 우선 스케일은, (this.scale() - divisor.scale()) 입니다. 정확한 상의 정수부에 mc.precision 보다 많은 자리수가 필요한 경우, ArithmeticException이 발생 됩니다.

파라미터:: divisor - 이 BigDecimal를 제산하는 값; mc - 사용하는 컨텍스트
반환값:: this / divisor 정수부
예외:: ArithmeticException - divisor==0 인 경우; ArithmeticException - mc.precision가 0 보다 크고, 결과에 mc.precision 보다 자리수가 많은 정밀도가 필요한 경우
도입된 버전 :: 1.5

remainder

public BigDecimal  remainder(BigDecimal  divisor)

값이 (this % divisor) BigDecimal를 리턴합니다.

잉여는 this.subtract(this.divideToIntegralValue(divisor). multiply(divisor))에 의해 제공됩니다. 이것은 모듈로 연산이 아닌 (부의 결과가 가능한) 것으로 유의해 주세요.

파라미터:: divisor - 이 BigDecimal를 제산하는 값
반환값:: this % divisor
예외:: ArithmeticException - divisor==0 인 경우
도입된 버전 :: 1.5

remainder

public BigDecimal  remainder(BigDecimal  divisor,
                            MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (this % divisor) 인 BigDecimal를 리턴합니다. MathContext 설정은 잉여의 계산에 사용하는 암묵적인 제산에 영향을 미칩니다. 정의가 가리키는 대로 잉여의 계산 자체는 정확하기 때문에 잉여는 mc.getPrecision() 보다 많은 자리수를 포함할 가능성이 있습니다.

잉여는 this.subtract(this.divideToIntegralValue(divisor). multiply(divisor))에 의해 제공됩니다. 이것은 모듈로 연산은 아닌 (부의 결과가 가능)인 것에 유의해 주세요.

파라미터:: divisor - 이 BigDecimal를 제산하는 값; mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 this % divisor
예외:: ArithmeticException - divisor==0 인 경우; ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY, 또는 mc.precision가 0 보다 크고, this.divideToIntgralValue(divisor) 결과에 mc.precision 보다 많은 자리수의 정밀도가 필요한 경우
도입된 버전 :: 1.5
관련 항목:: divideToIntegralValue(java.math.BigDecimal, java.math.MathContext)

divideAndRemainder

public BigDecimal [] divideAndRemainder(BigDecimal  divisor)

divideToIntegralValue 결과와 거기에 계속되는 2개의 오퍼랜드의 remainder 결과를 포함한, 2 요소의 BigDecimal 배열을 리턴합니다.

정수의 상과 잉여의 양쪽 모두가 필요한 경우, divideToIntegralValue 메서드와 remainder 메서드를 따로 따로 사용하는 것보다, 제산을 1회 만 실행하면 좋은 이 메서드가 고속으로 있는 것에 유의해 주세요.

파라미터:: divisor - 이 BigDecimal를 제산하는 값 및 계산된 잉여
반환값:: 2 요소의 BigDecimal 배열. 상 (divideToIntegralValue 결과)이 최초의 요소로 잉여가 마지막 요소
예외:: ArithmeticException - divisor==0 인 경우
도입된 버전 :: 1.5
관련 항목:: divideToIntegralValue(java.math.BigDecimal, java.math.MathContext), remainder(java.math.BigDecimal, java.math.MathContext)

divideAndRemainder

public BigDecimal [] divideAndRemainder(BigDecimal  divisor,
                                       MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해 계산된 divideToIntegralValue 결과와 2개의 오퍼랜드의 remainder 결과를 포함한, 2 요소의 BigDecimal 배열을 리턴합니다.

파라미터:: divisor - 이 BigDecimal를 제산하는 값 및 계산된 잉여; mc - 사용하는 컨텍스트
반환값:: 2 요소의 BigDecimal 배열. 상 (divideToIntegralValue 결과)이 최초의 요소로 잉여가 마지막 요소
예외:: ArithmeticException - divisor==0 인 경우; ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY, 또는 mc.precision가 0 보다 크고, this.divideToIntgralValue(divisor) 결과에 mc.precision 보다 많은 자리수의 정밀도가 필요한 경우
도입된 버전 :: 1.5
관련 항목:: divideToIntegralValue(java.math.BigDecimal, java.math.MathContext), remainder(java.math.BigDecimal, java.math.MathContext)

pow

public BigDecimal  pow(int n)

값이 (thisⁿ) 인 BigDecimal를 리턴합니다. 누승은 정밀도의 제한없이 정확하게 계산됩니다.

파라미터 n는 0 에서 999999999 범위에 들어가고 있을 필요가 있습니다. ZERO.pow(0)는 ONE를 리턴합니다. 장래의 릴리스에서는 이 메서드의 지수의 허용 범위가 확장될 가능성이 있습니다.

파라미터:: n - 이 BigDecimal 누승
반환값:: thisⁿ
예외:: ArithmeticException - n가 범위외에 있는 경우
도입된 버전 :: 1.5

pow

public BigDecimal  pow(int n,
                      MathContext  mc)

값이 (thisⁿ) 인 BigDecimal를 리턴합니다. 현재의 구현에서는 컨텍스트 설정에 따른 둥근으로 ANSI 규격 X3. 274-1996 그리고 정의된 코어 알고리즘을 사용하고 있습니다. 일반적으로 리턴된 수치는 선택된 정밀도의 정확한 수치의 2 ulp 이내입니다. 장래의 릴리스에서는 오차의 허용 범위를 좁은 지수의 허용 범위를 확대한 다른 알고리즘을 사용할 가능성이 있습니다.

X3. 274-1996 알고리즘은 다음과 같습니다.

ArithmeticException는 다음의 조건에 들어맞는 경우에 Throw 된다
- abs(n) > 999999999
- mc.precision == 0 또한 n < 0
- mc.precision > 0, 한편 n 10 진수자가 mc.precision 보다 많다
n가 0인 경우, this가 0 에서도 ONE 가 리턴된다. 그 외의 경우는 다음과 같이 된다
- n가 정의 경우, 제곱법을 반복해 단일의 누산기에 넣는 것으로 결과가 계산된다. 누산기를 가지는 개개의 곱셈에서는 mc.precision + elength + 1 (elength는 n 내의 10 진수자의 수)에 올린 정밀도를 제외해, mc와 같은 수학 컨텍스트 설정을 사용한다
- n가 부의 경우, n가 정인것 같이 결과가 계산된다. 그 후, 이 값은 전술의 유효한 정밀도를 사용해 1 보다 제산된다
- 정 또는 부의 경우의 최종적인 값이, 목표의 정밀도에 말 수 있다

파라미터:: n - 이 BigDecimal 누승; mc - 사용하는 컨텍스트
반환값:: ANSI standard X3. 274-1996 알고리즘을 사용한 thisⁿ
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY, 또는 n가 범위외인 경우
도입된 버전 :: 1.5

abs

public BigDecimal  abs()

값이 이 BigDecimal 절대치로 스케일이 this.scale() BigDecimal를 리턴합니다.

반환값:: abs(this)

abs

public BigDecimal  abs(MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 이 BigDecimal 절대치인 BigDecimal를 리턴합니다.

파라미터:: mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 abs(this)
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우

negate

public BigDecimal  negate()

값이 (-this)로 스케일이 this.scale() BigDecimal를 리턴합니다.

반환값:: -this

negate

public BigDecimal  negate(MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (-this) 인 BigDecimal를 리턴합니다.

파라미터:: mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 -this
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5

plus

public BigDecimal  plus()

값이 (+this)로 스케일이 this.scale() BigDecimal를 리턴합니다.

이 BigDecimal를 단지 돌려줄 뿐의 이 메서드는 단항 마이너스 메서드 negate() 대칭으로서 포함되어 있습니다.

반환값:: this
도입된 버전 :: 1.5
관련 항목:: negate()

plus

public BigDecimal  plus(MathContext  mc)

컨텍스트 설정에 따른 둥근을 사용해, 값이 (+this) 인 BigDecimal를 리턴합니다.

이 메서드의 효과는 round(MathContext) 메서드의 효과와 같습니다.

파라미터:: mc - 사용하는 컨텍스트
반환값:: 필요에 따라서 말 수 있었던 this. 0 결과의 스케일은 0
예외:: ArithmeticException - 결과가 정확하지 않고 둥근 모드가 UNNECESSARY인 경우
도입된 버전 :: 1.5
관련 항목:: round(MathContext)

signum

public int signum()

이 BigDecimal 부호치를 리턴합니다.

반환값:: 이 BigDecimal가 부의 경우는 -1, 제로의 경우는 0, 정의 경우는 1

scale

public int scale()

이 BigDecimal 「스케일」을 리턴합니다. 0 또는 정의 경우, 스케일은 소수점 아래의 자리수입니다. 부의 경우, 스케일 없음의 수치에 스케일의 정부를 반대로 한 값을 지수로 하는 10 누승을 곱셈합니다. 예를 들어, -3 스케일에서는 스케일 없음의 값에 1000 이 곱셈됩니다.

반환값:: 이 BigDecimal 스케일

precision

public int precision()

이 BigDecimal 「정밀도」를 리턴합니다. 정밀도란 스케일 없음의 값의 자리수입니다.

0 정밀도는 1 입니다.

반환값:: 이 BigDecimal 정밀도
도입된 버전 :: 1.5

unscaledValue

public BigInteger  unscaledValue()

값이 이 BigDecimal 「스케일 없음의 값」인 BigInteger를 리턴합니다 ((this * 10^this.scale())를 계산한다).

반환값:: 이 BigDecimal 스케일 없음의 값
도입된 버전 :: 1.2

round

public BigDecimal  round(MathContext  mc)

MathContext 설정에 따라 말 수 있었던 BigDecimal를 리턴합니다. 정밀도 설정이 0인 경우, 둥근은 실행되지 않습니다.

이 메서드의 결과는 plus(MathContext) 메서드의 결과와 같습니다.

파라미터:: mc - 사용하는 컨텍스트
반환값:: MathContext 설정에 따라 말 수 있었던 BigDecimal
예외:: ArithmeticException - 둥근 모드가 UNNECESSARY로 BigDecimal 연산에 둥근이 필요한 경우
도입된 버전 :: 1.5
관련 항목:: plus(MathContext)

setScale

public BigDecimal  setScale(int newScale,
                           RoundingMode  roundingMode)

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

파라미터:: newScale - 리턴된 BigDecimal 값의 스케일; roundingMode - 적용하는 둥근 모드
반환값:: 스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 BigDecimal 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 누승의 적 또는 상에 의해 결정되는 BigDecimal
예외:: ArithmeticException - roundingMode==UNNECESSARY 이며, 지정한 스케일 연산으로 둥근이 필요한 경우
도입된 버전 :: 1.5
관련 항목:: RoundingMode

setScale

public BigDecimal  setScale(int newScale,
                           int roundingMode)

BigDecimal 객체는 불변이기 때문에 setX 메서드로 필드 X를 변경하는 보통 의 규칙과는 달라, 이 메서드를 호출해도 원의 객체는 변경되지 않는 것에 주의해 주세요. 대신에 setScale는 적절한 스케일을 가지는 객체를 리턴합니다. 리턴된 객체는 새롭게 할당할 수 있는 경우와 그렇지 않은 경우가 있습니다.

이 유산 메서드보다, 새로운 setScale(int, RoundingMode) 메서드를 사용해 주세요.

파라미터:: newScale - 리턴된 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 newScale)

스케일이 지정된 값이며, 값이 이 BigDecimal 과 같은 수치인, BigDecimal를 리턴합니다. 이것이 불가능한 경우, ArithmeticException을 Throw 합니다.

보통, 이 호출은 스케일의 확장에 사용되어 그 경우에는 지정된 스케일과 올바른 값의 BigDecimal 존재가 보증됩니다. 값을 변경하는 일 없이 재슬캘링을 실시하는데 충분한 0 이 BigDecimal의 소수부 (그 정수값에 있어서의 10 인수)의 마지막에 있는 것을 호출측이 인식하고 있는 경우, 이 호출은 스케일의 축소에도 사용할 수 있습니다.

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

BigDecimal 객체는 불변이기 때문에 setX 메서드로 필드 X를 변경하는 보통 의 규칙과는 대조적으로 이 메서드를 호출해도 원의 객체는 변경되지 않는 것에 주의해 주세요. 대신에 setScale는 적절한 스케일을 가지는 객체를 리턴합니다. 리턴된 객체는 새롭게 할당할 수 있는 경우와 그렇지 않은 경우가 있습니다.

파라미터:: newScale - 리턴된 BigDecimal 값의 스케일
반환값:: 스케일이 지정된 값이며, 한편 스케일 없음의 값이, 이 BigDecimal 스케일 없음의 값과 총체치를 유지할 수 있는 적당한 10 누승의 적 또는 상에 의해 결정되는 BigDecimal
예외:: ArithmeticException - 지정한 스케일 연산으로 둥근이 필요한 경우
관련 항목:: setScale(int, int), setScale(int, RoundingMode)

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
예외:: ArithmeticException - 스케일이 오버플로우 하는 경우

movePointRight

public BigDecimal  movePointRight(int n)

소수점을 n 형우에 이동해 이것에 동일한 BigDecimal를 리턴합니다. n가 부가 아닌 경우는 스케일로부터 n를 단지 감산합니다. n가 부의 경우는 movePointLeft(-n)에 동일해집니다. 이 호출로 리턴된 BigDecimal의 값은 (this × 10ⁿ), 스케일은 max(this.scale() -n, 0) 입니다.

파라미터:: n - 소수점을 오른쪽에 이동하는 자리수
반환값:: 소수점을 n 형우에 이동한, 이것에 동일한 BigDecimal
예외:: ArithmeticException - 스케일이 오버플로우 하는 경우

scaleByPowerOfTen

public BigDecimal  scaleByPowerOfTen(int n)

수값이 (this * 10ⁿ)에 동일한 BigDecimal를 리턴합니다. 결과의 스케일은 (this.scale() - n) 입니다.

예외:: ArithmeticException - 스케일이 32 비트 정수의 범위외인 경우
도입된 버전 :: 1.5

stripTrailingZeros

public BigDecimal  stripTrailingZeros()

수치는 이것에 동일하지만, 후속의 0 이 표현으로부터 삭제된 BigDecimal를 리턴합니다. 예를 들어,[6000, 1]에 동일한 [BigInteger, scale] 컴퍼넌트를 가지는 BigDecimal 치 600.0 으로부터 후속의 0을 없애면,[6, -2]에 동일한 [BigInteger, scale] 컴퍼넌트를 가지는 6E2가 됩니다.

반환값:: 후속의 0 이 삭제된, 수치의 동일한 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개가 들어갑니다.

정의:: 인터페이스 Comparable <BigDecimal > 내의 compareTo

파라미터:: val - 이 BigDecimal와 비교하는 BigDecimal
반환값:: 이 BigDecimal 수값이 val 보다 작은 경우는 -1, 동일한 경우는 0, 큰 경우는 1

equals

public boolean equals(Object  x)

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

오버라이드(override):: 클래스 Object 내의 equals

파라미터:: x - 이 BigDecimal와 비교하는 Object
반환값:: 지정한 Object가 이 BigDecimal 과 값도 스케일도 동일한 BigDecimal 인 경우에만 true
관련 항목:: compareTo(java.math.BigDecimal), hashCode()

min

public BigDecimal  min(BigDecimal  val)

이 BigDecimal와 val 최소값을 리턴합니다.

파라미터:: val - 최소값의 계산에 사용하는 값
반환값:: 이 BigDecimal 과 val 가운데로 작은 (분)편의 값을 가지는 BigDecimal. compareTo 메서드로 정의되고 있는 비교 방법으로 값이 동일한 경우는 this가 리턴된
관련 항목:: compareTo(java.math.BigDecimal)

max

public BigDecimal  max(BigDecimal  val)

이 BigDecimal와 val 최대값을 리턴합니다.

파라미터:: val - 최대값 의 계산에 사용하는 값
반환값:: 이 BigDecimal 과 val 가운데로 큰 (분)편의 값을 가지는 BigDecimal. compareTo 메서드로 정의되고 있는 비교 방법으로 값이 동일한 경우는 this가 리턴된
관련 항목:: compareTo(java.math.BigDecimal)

hashCode

public int hashCode()

이 BigDecimal 해시 코드를 리턴합니다. 값이 동일하지만 스케일이 다른 2개의 BigDecimal 객체 (예를 들어 2.0 으로 2.00)는 일반적으로 해시 코드가 다릅니다.

오버라이드(override):: 클래스 Object 내의 hashCode

반환값:: 이 BigDecimal 해시 코드
관련 항목:: equals(Object)

toString

public String  toString()

지수가 필요한 경우, 과학 표기법으로 이 BigDecimal 캐릭터 라인 표현을 리턴합니다.

BigDecimal 표준적인 캐릭터 라인 형식은 다음의 순서로 작성됩니다. 우선, BigDecimal 스케일 없음의 값의 절대값이 「0」으로부터 「9」까지의 문자를 사용한, 선두에 0 이 붙지 않는 캐릭터 라인 (기수 10)에 변환됩니다 (다만, 값이 0 인 경우는 단일의 문자 「0」이 사용된다).

다음에 「조정된 지수」가 계산됩니다. 이것은 정부를 반대로 한 스케일에 변환된 스케일 없음의 값의 문자수를 가산한 것으로부터 1을 감산한 것입니다. 즉, -scale+(ulength-1) 이며, ulength는 10 진수의 스케일 없음의 값의 절대치의 길이 ( 「정밀도」)입니다.

스케일이 0 이상으로 조정된 지수가 -6 이상인 경우, 수치는 지수 표현 없음의 문자 형식에 변환됩니다. 이 경우 스케일이 0 때는 소수점은 추가되지 않습니다. 스케일이 정 때는 소수점이 스케일과 함께 삽입되어 소수점 아래의 문자수가 지정됩니다. 필요에 따라서, 변환된 스케일 없음의 값의 왼쪽으로 문자 「0」이 추가됩니다. 이 삽입의 후에 소수점에 선행하는 문자가 없는 경우, 관례에 따라 문자 「0」을 선두에 붙일 수 있습니다.

그 외의 경우 (즉, 스케일이 부, 또는 조정된 지수가 -6 미만의 경우), 수치는 지수 표현을 사용해 문자 형식에 변환됩니다. 이 경우 변환된 BigInteger에 복수의 자리수가 있을 때, 최초의 자리수의 뒤로 소수점이 삽입됩니다. 다음에 변환된 스케일 없음의 값의 뒤로 (삽입된 소수점과 함께) 문자 형식의 지수를 붙일 수 있습니다. 이것은 문자 「E」 및 그 직후의 조정된 지수를 문자 형식으로 변환한 것으로 구성됩니다. 후자는 기수 10 으로 선두에 0 이 붙지 않고, 「0」~ 「9」를 사용해, 조정된 지수가 부의 경우는 반드시 선두에 부호 문자 「-」( 「\u002D」), 그렇지 않은 경우는 「+」( 「\u002B」)이 붙어 있습니다.

마지막으로 스케일 없음의 값이 0 미만의 경우는 캐릭터 라인 전체의 선두에 마이너스 부호 문자 「-」( 「\u002D」)이 붙일 수 있습니다. 스케일 없음의 값이 0 또는 정의 경우, 부호 문자는 붙일 수 없습니다.

례:

각 표현의 좌측은 [unscaled value, scale], 우측은 결과의 캐릭터 라인을 나타냅니다.


 [123,0]      "123"
 [-123, 0]     "-123"
 [123,-1]     "1. 23E+3"
 [123,-3]     "1. 23E+5"
 [123,1]      "12. 3"
 [123,5]      "0. 00123"
 [123,10]     "1. 23E-8"
 [-123, 12]    "-1. 23E-10"

주:

구별 가능한 BigDecimal 치와 이 변환의 결과의 사이에는 1 대 1 매핑이 있다. 즉, 모든 구별 가능한 BigDecimal 치 (스케일 없음의 값과 스케일)는 toString를 사용한 결과적으로 일의의 캐릭터 라인 표현을 가진다. BigDecimal(String) 생성자를 사용해 그 캐릭터 라인 표현을 BigDecimal에 되돌리면, 원의 값이 복원된다
특정의 수치를 위해서 생성된 캐릭터 라인은 항상 같고, 로케일에 한 영향은 받지 않는다. 즉, 10 진수 데이터를 교환하기 위한 표준적인 캐릭터 라인 표현, 즉 해시 테이블의 키등으로 해서 사용할 수가 있다. 로케일에 의존된 수치의 포맷과 해석은, NumberFormat 클래스와 그 서브 클래스에 의해 처리된다
기술 표기법에서의 지수를 사용한 수치 표현에는 toEngineeringString() 메서드를, BigDecimal 둥근에는 소수점 아래의 자리수가 기존인 setScale 메서드를, 각각 사용할 수 있다
Character.forDigit에 의해 제공되는 숫자로부터 문자에의 매핑이 사용된다

오버라이드(override):: 클래스 Object 내의 toString

반환값:: 이 BigDecimal 캐릭터 라인 표현
관련 항목:: Character.forDigit(int, int), BigDecimal(java.lang.String)

toEngineeringString

public String  toEngineeringString()

지수가 필요한 경우, 기술 표기법으로 이 BigDecimal 캐릭터 라인 표현을 리턴합니다.

toString() 메서드로 기술되고 있도록, BigDecimal를 나타내는 캐릭터 라인을 리턴합니다. 다만, 지수 표현이 사용되는 경우, 0 이 아닌 값의 정수부가 1 ~ 999 범위에 들어가도록, 10 누승은 3 배수 (기술 표기법)에 조정됩니다. 값 0에 대해 지수 표현이 사용되는 경우, 값 0 스케일을 유지하기 위해서 소수점과 1개 또는 2개의 소수부의 자리수가 사용됩니다. toString() 출력과 달라, 이 메서드의 출력으로는 캐릭터 라인 생성자 을 사용해 출력 캐릭터 라인을 BigDecimal에 되돌렸을 때에 BigDecimal 같은 [integer, scale] 페어의 복원은 보증되지 않는 것에 주의해 주세요. 이 메서드의 결과는 캐릭터 라인 생성자를 메서드의 출력에 적용한 결과와 등가인 수치를 항상 생성한다고 하는 약한 제약을 채웁니다.

반환값:: 지수가 필요한 경우, 기술 표기법에 따르는 이 BigDecimal 캐릭터 라인 표현
도입된 버전 :: 1.5

toPlainString

public String  toPlainString()

지수 필드없이, 이 BigDecimal 캐릭터 라인 표현을 리턴합니다. 정의 스케일을 가지는 값의 경우, 소수점 아래의 자리수는 스케일을 나타내기 위해서 사용됩니다. 스케일이 0 또는 잘못된 값 의 경우, 결과의 캐릭터 라인은 그 값이 스케일 0을 가지는 수치적으로 등가인 값에 변환되어 스케일 0 값의 후속의 0 모든 것이 결과에 존재하는것 같이 생성됩니다. 스케일 없음의 값이 0 미만의 경우, 캐릭터 라인 전체의 선두에 마이너스 부호 문자 「-」( 「\u002D」)이 붙일 수 있습니다. 스케일 없음의 값이 0 또는 정의 경우, 부호 문자는 붙일 수 없습니다.이 메서드의 결과가캐릭터 라인 생성자 에게 건네지는 경우, 이 BigDecimal 수치만이 반드시 복원됩니다. 새로운 BigDecimal 표현은 다른 스케일을 가질 가능성이 있습니다. 특히, 이 BigDecimal가 정의 스케일을 가지는 경우, 이 메서드의 결과의 캐릭터 라인은 캐릭터 라인 생성자에 의해 처리될 때 스케일 0을 가집니다. (이 메서드의 동작은 1.4 이전의 릴리스에서의 toString 메서드와 같이)

반환값:: 이 BigDecimal, 지수 필드가 없는 캐릭터 라인 표현
도입된 버전 :: 1.5
관련 항목:: toString(), toEngineeringString()

toBigInteger

public BigInteger  toBigInteger()

이 BigDecimal를 BigInteger로 변환합니다. 이 변환은, 「Java 언어 사양」으로 정의된 double로 부터 long에 의 「네로우 원시적 변환」이라고 같습니다. 이 BigDecimal 소수부는 모두 파기됩니다. 이 변환에의해 BigDecimal 치의 정밀도에 관한 정보가 없어질 가능성이 있습니다.

변환이 정확하지 않은 (즉, 0 이외의 소수부가 파기된다) 경우에 예외를 Throw 하려면, toBigIntegerExact() 메서드를 사용해 주세요.

반환값:: BigInteger에 변환된 이 BigDecimal

toBigIntegerExact

public BigInteger  toBigIntegerExact()

이 BigDecimal를 BigInteger로 변환해, 없어진 정보가 있는지 없는지를 확인합니다. 이 BigDecimal에 0 이외의 소수부가 있는 경우, 예외가 발생 됩니다.

반환값:: BigInteger에 변환된 이 BigDecimal
예외:: ArithmeticException - this가 0 이외의 소수부를 가지는 경우
도입된 버전 :: 1.5

longValue

public long longValue()

이 BigDecimal를 long로 변환합니다. 이 변환은, 「Java 언어 사양」으로 정의된 double로 부터 short에 의 「네로우 원시적 변환」이라고 같습니다. 이 BigDecimal 소수부는 모두 파기됩니다. 결과의 「BigInteger」가 너무 길어 long 내에 들어가지 않는 경우, 하위 64 비트만이 리턴됩니다 . 이 변환에의해 이 BigDecimal 치의 절대치와 정밀도 전체에 관한 정보가 없어져 역의 부호로 돌려주고질 가능성이 있습니다.

정의:: 클래스 Number 내의 longValue

반환값:: long에 변환된 이 BigDecimal

longValueExact

public long longValueExact()

이 BigDecimal를 long로 변환해, 없어진 정보가 있는지 없는지를 확인합니다. 이 BigDecimal에 0 이외의 소수부가 있다, 또는 long 결과로서 가능한 범위외인 경우, ArithmeticException이 발생 됩니다.

반환값:: long에 변환된 이 BigDecimal
예외:: ArithmeticException - this가 0 이외의 소수부를 가진다, 또는 long 내에 들어가지 않는 경우
도입된 버전 :: 1.5

intValue

public int intValue()

이 BigDecimal를 int로 변환합니다. 이 변환은, 「Java 언어 사양」으로 정의된 double로 부터 short에 의 「네로우 원시적 변환」이라고 같습니다. 이 BigDecimal 소수부는 모두 파기됩니다. 결과의 「BigInteger」가 너무 길어 int 내에 들어가지 않는 경우, 하위 32 비트만이 리턴됩니다 . 이 변환에의해 이 BigDecimal 치의 절대치와 정밀도 전체에 관한 정보가 없어져 역의 부호로 돌려주고질 가능성이 있습니다.

정의:: 클래스 Number 내의 intValue

반환값:: int에 변환된 이 BigDecimal

intValueExact

public int intValueExact()

이 BigDecimal를 int로 변환해, 없어진 정보가 있는지 없는지를 확인합니다. 이 BigDecimal에 0 이외의 소수부가 있다, 또는 int 결과로서 가능한 범위외인 경우, ArithmeticException이 발생 됩니다.

반환값:: int에 변환된 이 BigDecimal
예외:: ArithmeticException - this가 0 이외의 소수부를 가진다, 또는 int 내에 들어가지 않는 경우
도입된 버전 :: 1.5

shortValueExact

public short shortValueExact()

이 BigDecimal를 short로 변환해, 없어진 정보가 있는지 없는지를 확인합니다. 이 BigDecimal에 0 이외의 소수부가 있다, 또는 short 결과로서 가능한 범위외인 경우, ArithmeticException이 발생 됩니다.

반환값:: short에 변환된 이 BigDecimal
예외:: ArithmeticException - this가 0 이외의 소수부를 가진다, 또는 short 내에 들어가지 않는 경우
도입된 버전 :: 1.5

byteValueExact

public byte byteValueExact()

이 BigDecimal를 byte로 변환해, 없어진 정보가 있는지 없는지를 확인합니다. 이 BigDecimal에 0 이외의 소수부가 있다, 또는 byte 결과로서 가능한 범위외인 경우, ArithmeticException이 발생 됩니다.

반환값:: byte에 변환된 이 BigDecimal
예외:: ArithmeticException - this가 0 이외의 소수부를 가진다, 또는 byte 내에 들어가지 않는 경우
도입된 버전 :: 1.5

floatValue

public float floatValue()

이 BigDecimal를 float로 변환합니다. 이 변환은, 「Java 언어 사양」으로 정의된 double로 부터 float에 의 「네로우 원시적 변환」이라고 같습니다. 이 BigDecimal 절대값이 너무 커 float로 서 표현할 수 없는 경우, 적당 Float.NEGATIVE_INFINITY 또는 Float.POSITIVE_INFINITY에 변환됩니다. 반환값이 유한한 경우도, 이 변환에의해 BigDecimal 치의 정밀도에 관한 정보가 없어질 가능성이 있습니다.

정의:: 클래스 Number 내의 floatValue

반환값:: float에 변환된 이 BigDecimal

doubleValue

public double doubleValue()

이 BigDecimal를 double로 변환합니다. 이 변환은, 「Java 언어 사양」으로 정의된 double로 부터 float에 의 「네로우 원시적 변환」이라고 같습니다. 이 BigDecimal 절대값이 너무 커 double로 서 표현할 수 없는 경우, 적당 Double.NEGATIVE_INFINITY 또는 Double.POSITIVE_INFINITY에 변환됩니다. 반환값이 유한한 경우도, 이 변환에의해 BigDecimal 치의 정밀도에 관한 정보가 없어질 가능성이 있습니다.

정의:: 클래스 Number 내의 doubleValue

반환값:: double에 변환된 이 BigDecimal

ulp

public BigDecimal  ulp()

이 BigDecimal ulp (최종자리수 단위)의 사이즈를 리턴합니다. 0 이외의 BigDecimal 치의 ulp는 이 값과 다음에 큰 절대치 및 같은 자리수를 가지는 BigDecimal 치의 사이의 정의 거리입니다. 값 0 ulp는 스케일 this를 가지는 1 으로 수값이 동일해집니다. 결과는 this와 같은 스케일로 포함되어 0 및 0 이외의 값의 결과는 [1, this.scale()]와 동일해집니다.

반환값:: this ulp 사이즈
도입된 버전 :: 1.5

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

전의 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.math 클래스 BigDecimal

산술 연산의 결과로 우선되는 스케일

ZERO

ONE

TEN

ROUND_UP

ROUND_DOWN

ROUND_CEILING

ROUND_FLOOR

ROUND_HALF_UP

ROUND_HALF_DOWN

ROUND_HALF_EVEN

ROUND_UNNECESSARY

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

BigDecimal

valueOf

valueOf

valueOf

add

add

subtract

subtract

multiply

multiply

divide

divide

divide

divide

divide

divide

divideToIntegralValue

divideToIntegralValue

remainder

remainder

divideAndRemainder

divideAndRemainder

pow

pow

abs

abs

negate

negate

plus

plus

signum

scale

precision

unscaledValue

round

setScale

setScale

setScale

movePointLeft

movePointRight

scaleByPowerOfTen

stripTrailingZeros

compareTo

equals

min

max

hashCode

toString

toEngineeringString

toPlainString

toBigInteger

toBigIntegerExact

java.math
클래스 BigDecimal