Most visited

Recently visited

Added in API level 1

MathContext

public final class MathContext
extends Object implements Serializable

java.lang.Object
   ↳ java.math.MathContext


不可变的对象,描述类 BigDecimal提供的数值操作的舍入模式和数字精度等设置。

Summary

Fields

public static final MathContext DECIMAL128

A MathContext ,它对应于 IEEE 754四位十进制精度格式:34位精度和 HALF_EVEN舍入。

public static final MathContext DECIMAL32

A MathContext ,它对应于 IEEE 754单精度十进制精度格式:7位精度和 HALF_EVEN舍入。

public static final MathContext DECIMAL64

A MathContext ,它对应于 IEEE 754双精度十进制精度格式:16位精度和 HALF_EVEN舍入。

public static final MathContext UNLIMITED

一个 MathContext无限精度, HALF_UP四舍五入。

Public constructors

MathContext(int precision)

构造一个新的 MathContext与指定的精度和与舍入模式 HALF_UP

MathContext(int precision, RoundingMode roundingMode)

用指定的精度和指定的舍入模式构造一个新的 MathContext

MathContext(String s)

从字符串构造一个新的 MathContext

Public methods

boolean equals(Object x)

如果x是具有与此 MathContext实例相同的精度设置和相同舍入模式的 MathContext ,则返回true。

int getPrecision()

返回精度。

RoundingMode getRoundingMode()

返回舍入模式。

int hashCode()

返回此 MathContext实例的哈希码。

String toString()

返回此 MathContext实例的字符串表示形式。

Inherited methods

From class java.lang.Object

Fields

DECIMAL128

Added in API level 1
MathContext DECIMAL128

A MathContext ,它对应于 IEEE 754四倍小数精度格式:34位精度和 HALF_EVEN舍入。

DECIMAL32

Added in API level 1
MathContext DECIMAL32

一个 MathContext ,它对应于 IEEE 754单精度格式:7位精度和 HALF_EVEN舍入。

DECIMAL64

Added in API level 1
MathContext DECIMAL64

A MathContext ,它对应于 IEEE 754双精度十进制精度格式:16位精度和 HALF_EVEN舍入。

UNLIMITED

Added in API level 1
MathContext UNLIMITED

一个 MathContext无限精度和 HALF_UP舍入。

Public constructors

MathContext

Added in API level 1
MathContext (int precision)

构造一个新的MathContext与指定的精度和与舍入模式HALF_UP 如果传递的精度为零,那么这意味着计算必须准确执行,在这种情况下舍入模式是不相关的。

Parameters
precision int: the precision for the new MathContext.
Throws
IllegalArgumentException if precision < 0.

MathContext

Added in API level 1
MathContext (int precision, 
                RoundingMode roundingMode)

用指定的精度和指定的舍入模式构造一个新的MathContext 如果传递的精度为零,那么这意味着计算必须准确执行,在这种情况下舍入模式是不相关的。

Parameters
precision int: the precision for the new MathContext.
roundingMode RoundingMode: the rounding mode for the new MathContext.
Throws
IllegalArgumentException if precision < 0.
NullPointerException if roundingMode is null.

MathContext

Added in API level 1
MathContext (String s)

从一个字符串构造一个新的MathContext 字符串必须指定要使用的精度和舍入模式,并且必须遵循以下语法:“precision = <precision> roundingMode = <roundingMode>”这与toString()方法返回的格式相同。

Parameters
s String
Throws
IllegalArgumentException if the string is not in the correct format or if the precision specified is < 0.

Public methods

equals

Added in API level 1
boolean equals (Object x)

如果x是具有与此 MathContext实例相同的精度设置和相同舍入模式的 MathContext ,则返回true。

Parameters
x Object: object to be compared.
Returns
boolean true if this MathContext instance is equal to the x argument; false otherwise.

getPrecision

Added in API level 1
int getPrecision ()

返回精度。 精度是用于操作的位数。 结果四舍五入到这个精度。 精度保证是非负的。 如果精度为零,那么必须精确执行计算,在这种情况下结果不会被舍入。

Returns
int the precision.

getRoundingMode

Added in API level 1
RoundingMode getRoundingMode ()

返回舍入模式。 舍入模式是用于对结果进行舍入的策略。

舍入模式是以下之一 UPDOWNCEILINGFLOORHALF_UPHALF_DOWNHALF_EVEN ,或 UNNECESSARY

Returns
RoundingMode the rounding mode.

hashCode

Added in API level 1
int hashCode ()

返回此 MathContext实例的哈希码。

Returns
int the hash code for this MathContext.

toString

Added in API level 1
String toString ()

返回此MathContext实例的字符串表示形式。 该字符串的格式为"precision=<precision> roundingMode=<roundingMode>" ,其中<precision>是描述用于操作的位数的整数, <roundingMode>是舍入模式的字符串表示形式。

Returns
String a string representation for this MathContext instance

Hooray!