java.math

Class MathContext

public final class MathContext extends Object implements Serializable

Immutable objects describing settings such as rounding mode and digit precision for numerical operations such as those in the BigDecimal class.

Field Summary
static MathContext	DECIMAL128 A MathContext for the IEEE 754R Decimal128 format - 34 digit preicision and HALF_EVEN rounding.
static MathContext	DECIMAL32 A MathContext for the IEEE 754R Decimal32 format - 7 digit preicision and HALF_EVEN rounding.
static MathContext	DECIMAL64 A MathContext for the IEEE 754R Decimal64 format - 16 digit preicision and HALF_EVEN rounding.
static MathContext	UNLIMITED A MathContext for unlimited precision arithmetic *

Constructor Summary
	MathContext(int setPrecision) Constructs a new MathContext with the specified precision and with HALF_UP rounding.
	MathContext(int setPrecision, RoundingMode setRoundingMode) Constructs a new MathContext with the specified precision and rounding mode.
	MathContext(String val) Constructs a MathContext from a String that has the same form as one produced by the toString() method.

Method Summary
boolean	equals(Object x) Returns true if x is a MathContext and has the same precision setting and rounding mode as this MathContext.
int	getPrecision() Returns the precision setting.
RoundingMode	getRoundingMode() Returns the rounding mode setting.
int	hashCode() Returns the hashcode for this MathContext.
String	toString() Returns "precision=p roundingMode=MODE" where p is an int giving the precision and MODE is UP, DOWN, HALF_UP, HALF_DOWN, HALF_EVEN, CEILING, FLOOR, or UNNECESSARY corresponding to rounding modes.

Field Detail

DECIMAL128

public static final MathContext DECIMAL128

A MathContext for the IEEE 754R Decimal128 format - 34 digit preicision and HALF_EVEN rounding.

DECIMAL32

public static final MathContext DECIMAL32

A MathContext for the IEEE 754R Decimal32 format - 7 digit preicision and HALF_EVEN rounding.

DECIMAL64

public static final MathContext DECIMAL64

A MathContext for the IEEE 754R Decimal64 format - 16 digit preicision and HALF_EVEN rounding.

UNLIMITED

public static final MathContext UNLIMITED

A MathContext for unlimited precision arithmetic *

Constructor Detail

MathContext

public MathContext(int setPrecision)

Constructs a new MathContext with the specified precision and with HALF_UP rounding.

Parameters: setPrecision the precision for the new MathContext

Throws: IllegalArgumentException if precision is < 0.

MathContext

public MathContext(int setPrecision, RoundingMode setRoundingMode)

Constructs a new MathContext with the specified precision and rounding mode.

Parameters: setPrecision the precision setRoundingMode the rounding mode

Throws: IllegalArgumentException if precision is < 0.

MathContext

public MathContext(String val)

Constructs a MathContext from a String that has the same form as one produced by the toString() method.

Parameters: val

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

Method Detail

equals

public boolean equals(Object x)

Returns true if x is a MathContext and has the same precision setting and rounding mode as this MathContext.

Returns: true if the above conditions hold

getPrecision

public int getPrecision()

Returns the precision setting.

Returns: the precision setting.

Returns the rounding mode setting. This will be one of RoundingMode.CEILING, RoundingMode.DOWN, RoundingMode.FLOOR, RoundingMode.HALF_DOWN, RoundingMode.HALF_EVEN, RoundingMode.HALF_UP, RoundingMode.UNNECESSARY, or RoundingMode.UP.

Returns: the rounding mode setting.

hashCode

public int hashCode()

Returns the hashcode for this MathContext.

Returns: the hashcode for this MathContext.

toString

public String toString()

Returns "precision=p roundingMode=MODE" where p is an int giving the precision and MODE is UP, DOWN, HALF_UP, HALF_DOWN, HALF_EVEN, CEILING, FLOOR, or UNNECESSARY corresponding to rounding modes.

Returns: a String describing this MathContext