JavaTM Platform
Standard Ed. 6

java.math
클래스 MathContext

java.lang.Object 
  상위를 확장 java.math.MathContext
모든 구현된 인터페이스:
Serializable


public final class MathContext
extends Object
implements Serializable

BigDecimal 클래스에 의해 구현되는 수치 연산자등의 특정의 규칙을 기술하는 문맥 설정을 캡슐화하는 불변 객체.

베이스에 의존하지 않는 설정으로서 다음의 것이 있습니다.

  1. precision: 연산에 사용하는 자리수. 결과는 이 정밀도에 말 수 있다
  2. roundingMode: RoundingMode 객체. 둥근 처리를 위한 알고리즘을 지정한다

도입된 버젼:
1.5
관련 항목:
BigDecimal , RoundingMode , 직렬화 된 형식

필드의 개요
static MathContext DECIMAL128
          IEEE 754R Decimal28 형식, 34 자리수, 둥근 모드는 IEEE 754R 의 디폴트인 HALF_EVEN 의 정밀도가 설정된 MathContext 객체입니다.
static MathContext DECIMAL32
          IEEE 754R Decimal32 형식, 7 자리수, 둥근 모드는 IEEE 754R 의 디폴트인 HALF_EVEN 의 정밀도가 설정된 MathContext 객체입니다.
static MathContext DECIMAL64
          IEEE 754R Decimal64 형식, 16 자리수, 둥근 모드는 IEEE 754R 의 디폴트인 HALF_EVEN 의 정밀도가 설정된 MathContext 객체입니다.
static MathContext UNLIMITED
          무제한의 정밀도에서의 계산에 필요한 값이 설정되어 있는 MathContext 객체입니다.
 
생성자 의 개요
MathContext (int setPrecision)
          지정의 정밀도와 둥근 모드 HALF_UP 의 새로운 MathContext 를 구축합니다.
MathContext (int setPrecision, RoundingMode  setRoundingMode)
          지정의 정밀도와 둥근 모드의 새로운 MathContext 를 구축합니다.
MathContext (String  val)
          캐릭터 라인으로부터 새로운 MathContext 를 구축합니다.
 
메소드의 개요
 boolean equals (Object  x)
          이 MathContext 와 지정된 Object 가 동일한지 어떤지를 비교합니다.
 int getPrecision ()
          precision 설정을 돌려줍니다.
 RoundingMode getRoundingMode ()
          roundingMode 설정을 돌려줍니다.
 int hashCode ()
          이 MathContext 의 해시 코드를 돌려줍니다.
 String toString ()
          이 MathContext 의 캐릭터 라인 표현을 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

필드의 상세

UNLIMITED

public static final MathContext  UNLIMITED
무제한의 정밀도에서의 계산에 필요한 값이 설정되어 있는 MathContext 객체입니다. 설정치는 다음과 같습니다. precision=0 roundingMode=HALF_UP


DECIMAL32

public static final MathContext  DECIMAL32
IEEE 754R Decimal32 형식, 7 자리수, 둥근 모드는 IEEE 754R 의 디폴트인 HALF_EVEN 의 정밀도가 설정된 MathContext 객체입니다.


DECIMAL64

public static final MathContext  DECIMAL64
IEEE 754R Decimal64 형식, 16 자리수, 둥근 모드는 IEEE 754R 의 디폴트인 HALF_EVEN 의 정밀도가 설정된 MathContext 객체입니다.


DECIMAL128

public static final MathContext  DECIMAL128
IEEE 754R Decimal28 형식, 34 자리수, 둥근 모드는 IEEE 754R 의 디폴트인 HALF_EVEN 의 정밀도가 설정된 MathContext 객체입니다.

생성자 의 상세

MathContext

public MathContext(int setPrecision)
지정의 정밀도와 둥근 모드 HALF_UP 의 새로운 MathContext 를 구축합니다.

파라미터:
setPrecision - 부의 수 이외의 int 정밀도 설정
예외:
IllegalArgumentException - setPrecision 파라미터가 0 보다 작은 경우

MathContext

public MathContext(int setPrecision,
                   RoundingMode  setRoundingMode)
지정의 정밀도와 둥근 모드의 새로운 MathContext 를 구축합니다.

파라미터:
setPrecision - 부의 수 이외의 int 정밀도 설정
setRoundingMode - 사용하는 둥근 모드
예외:
IllegalArgumentException - setPrecision 파라미터가 0 보다 작은 경우
NullPointerException - 둥근 모드 인수가 null 의 경우

MathContext

public MathContext(String  val)
캐릭터 라인으로부터 새로운 MathContext 를 구축합니다. 캐릭터 라인의 형식은,toString() 메소드에 의해 생성된 형식이 아니면 안됩니다.

캐릭터 라인의 정밀도 부분이 범위외 (0 미만)의 경우, 또는 toString() 메소드에 의해 생성된 형식의 캐릭터 라인이 아닌 경우,IllegalArgumentException 가 throw 됩니다.

파라미터:
val - 해석되는 캐릭터 라인
예외:
IllegalArgumentException - 정밀도 부분이 범위외의 경우, 또는 형식이 부정한 경우
NullPointerException - 인수가 null 의 경우
메소드의 상세

getPrecision

public int getPrecision()
precision 설정을 돌려줍니다. 이 값은 항상 부이외입니다.

반환값:
precision 설정의 값을 나타낸다 int

getRoundingMode

public RoundingMode  getRoundingMode()
roundingMode 설정을 돌려줍니다. RoundingMode.CEILING ,RoundingMode.DOWN ,RoundingMode.FLOOR ,RoundingMode.HALF_DOWN ,RoundingMode.HALF_EVEN ,RoundingMode.HALF_UP ,RoundingMode.UNNECESSARY ,RoundingMode.UP 의 어느 쪽인가에 됩니다.

반환값:
roundingMode 설정의 값을 나타낸다 roundingMode 객체

equals

public boolean equals(Object  x)
MathContext 와 지정된 Object 가 동일한지 어떤지를 비교합니다.

오버라이드(override):
클래스 Object 내의 equals
파라미터:
x - 이 MathContext 라고 비교된다 Object
반환값:
지정된 Object 가, 이 객체와 설정이 완전히 같은 MathContext 객체인 경우에 한정해, true
관련 항목:
Object.hashCode() , Hashtable

hashCode

public int hashCode()
MathContext 의 해시 코드를 돌려줍니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
MathContext 의 해시 코드
관련 항목:
Object.equals(java.lang.Object) , Hashtable

toString

public String  toString()
MathContext 의 캐릭터 라인 표현을 돌려줍니다. 반환되는 String 는,MathContext 객체의 설정을, 단일의 공백 문자 (「\u0020」)로 단락지어진 2 개의 워드 (전후에 공백을 포함하지 않는다)로서 나타냅니다.
  1. 캐릭터 라인 「"precision="」. 직후에 정밀도 설정치로서Integer.toString 메소드에 의해 생성된 것 같은 수치 캐릭터 라인이 계속된다.
  2. 캐릭터 라인 「"roundingMode="」. 직후에 roundingMode 설정치로서 단일의 단어가 계속된다. 이 단어는,RoundingMode 열거형내의 대응하는 public 정수의 이름과 일치한다

다음에 예를 나타냅니다.

 precision=9 roundingMode=HALF_UP
 
장래, 이 클래스에 프로퍼티이 추가되는 일이 있었을 경우,toString 의 결과에 단어를 추가할 수가 있습니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
문맥 설정을 나타내는 String

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.