JavaTM 2 Platform
Standard Ed. 5.0

java.math
クラス MathContext

java.lang.Object
  上位を拡張 java.math.MathContext
すべての実装されたインタフェース:
Serializable

public final class MathContext
extends Object
implements Serializable

BigDecimal クラスに実装されているような数値演算子の規則について説明するコンテキスト設定をカプセル化する不変のオブジェクトです。

ベースに依存しない設定として、次のものがあります。

  1. precision: 演算に使用する桁数。結果はこの精度に丸められる
  2. roundingMode: RoundingMode オブジェクト。丸め処理のためのアルゴリズムを指定する

関連項目:
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 パラメータ

MathContext

public MathContext(int setPrecision,
                   RoundingMode setRoundingMode)
指定の精度と丸めモードの新しい MathContext を構築します。

パラメータ:
setPrecision - 負の数以外の int 精度設定
setRoundingMode - 使用する丸めモード
例外:
IllegalArgumentException - ゼロ未満の setPrecision パラメータ

MathContext

public MathContext(String val)
文字列から新しい MathContext を構築します。 文字列の形式は、toString() メソッドによって生成された形式でなければなりません。

文字列の精度部分が範囲外 (0 未満) の場合、または toString() メソッドによって生成された形式の文字列でない場合、IllegalArgumentException がスローされます。

パラメータ:
val - 解析される文字列
例外:
IllegalArgumentException - 精度パラメータが範囲外の場合、または形式が不正な場合
メソッドの詳細

getPrecision

public int getPrecision()
precision 設定を返します。この値は常に負以外です。

戻り値:
precision 設定の値を表す int

getRoundingMode

public RoundingMode getRoundingMode()
roundingMode 設定を返します。RoundingMode.CEILINGRoundingMode.DOWNRoundingMode.FLOORRoundingMode.HALF_DOWNRoundingMode.HALF_EVENRoundingMode.HALF_UPRoundingMode.UNNECESSARYRoundingMode.UP のいずれかになります。

戻り値:
roundingMode 設定の値を表す RoundingMode オブジェクト

equals

public boolean equals(Object x)
この MathContext と指定された Object が等しいかどうかを比較します。

オーバーライド:
クラス Object 内の equals
パラメータ:
x - この MathContext と比較する Object
戻り値:
指定された ObjectMathContext オブジェクトであり、このオブジェクトとまったく同じ設定である場合に限り true
関連項目:
Object.hashCode(), Hashtable

hashCode

public int hashCode()
この MathContext のハッシュコードを返します。

オーバーライド:
クラス 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 の結果に単語を追加することができます。

オーバーライド:
クラス Object 内の toString
戻り値:
コンテキスト設定を表す String

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。