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.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 が等しいかどうかを比較します。

オーバーライド:

クラス Object 内の equals

パラメータ:

x - この MathContext と比較する Object

戻り値:

指定された Object が MathContext オブジェクトであり、このオブジェクトとまったく同じ設定である場合に限り 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