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 一個 MathContext 物件，其精度設置與 IEEE 754R Decimal128 格式（即 34 個數字）比對，捨入網要為 HALF_EVEN，這是 IEEE 754R 的預設捨入網要。
static MathContext	DECIMAL32 一個 MathContext 物件，其精度設置與 IEEE 754R Decimal32 格式（即 7 個數字）比對，捨入網要為 HALF_EVEN，這是 IEEE 754R 的預設捨入網要。
static MathContext	DECIMAL64 一個 MathContext 物件，其精度設置與 IEEE 754R Decimal64 格式（即 16 個數字）比對，捨入網要為 HALF_EVEN，這是 IEEE 754R 的預設捨入網要。
static MathContext	UNLIMITED 其設置具有無限精度演算法所需值的 MathContext 物件。

建構子摘要

MathContext(int setPrecision)
建構一個新的 MathContext，它具有指定的精度和 HALF_UP 捨入網要。

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

一個 MathContext 物件，其精度設置與 IEEE 754R Decimal32 格式（即 7 個數字）比對，捨入網要為 HALF_EVEN，這是 IEEE 754R 的預設捨入網要。

DECIMAL64

public static final MathContext DECIMAL64

一個 MathContext 物件，其精度設置與 IEEE 754R Decimal64 格式（即 16 個數字）比對，捨入網要為 HALF_EVEN，這是 IEEE 754R 的預設捨入網要。

DECIMAL128

public static final MathContext DECIMAL128

一個 MathContext 物件，其精度設置與 IEEE 754R Decimal128 格式（即 34 個數字）比對，捨入網要為 HALF_EVEN，這是 IEEE 754R 的預設捨入網要。

建構子詳細資訊

MathContext

public MathContext(int setPrecision)

建構一個新的 MathContext，它具有指定的精度和 HALF_UP 捨入網要。

參數：

setPrecision - 非負 int 精度設置。

拋出：

IllegalArgumentException - 如果 setPrecision 參數小於零。

MathContext

public MathContext(int setPrecision,
                   RoundingMode setRoundingMode)

建構一個新的 MathContext，它具有指定的精度和捨入網要。

參數：

setPrecision - 非負 int 精度設置。

setRoundingMode - 要使用的捨入網要。

拋出：

IllegalArgumentException - 如果 setPrecision 參數小於零。

NullPointerException - 如果捨入網要參數為 null

MathContext

public MathContext(String val)

根據字元串建構一個新的 MathContext。 該字元串的格式必須與 toString() 方法產生的字元串的格式相同。

如果字元串的精度部分超出範圍 (< 0)，或者字元串的格式不是 toString() 方法創建的格式，則拋出 IllegalArgumentException。

參數：

val - 要解析的字元串

拋出：

IllegalArgumentException - 如果精度部分超出範圍或者格式不正確

NullPointerException - 如果參數為 null

方法詳細資訊

getPrecision

public int getPrecision()

返回 precision 設置。此值始終為非負數。

返回：

一個 int，它是 precision 設置的值

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' 分隔，且沒有前導空格和後綴空格），如下所示：

1. 字元串 "precision=" 後面緊跟以數字字元串形式表示的精度設置的值，該字元串像是由 Integer.toString 方法產生的。
2. 字元串 "roundingMode=" 後面緊跟以單詞表示的 roundingMode 設置的值。此單詞與 RoundingMode 列舉中對應的公共常數的名稱相同。

例如：

 precision=9 roundingMode=HALF_UP
 

如果向此類別添加了多個屬性，則以後可以將其他單詞添加到 toString 的結果中。

覆寫：

類別 Object 中的 toString

返回：

表示上下文設置的 String。