MathContext JDK 1.6)

Description

publicfinal class MathContext

Immutable objects which encapsulate the context settings which describe certain rules for numerical operators, such as those implemented by the BigDecimal class.

See also: BigDecimal RoundingMode

Constructors

public MathContext (int setPrecision)

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

Constructs a new MathContext with the specified
precision and the HALF_UP rounding
mode.
Parameters:
- setPrecision - The non-negative {@code int} precision setting.
Throws:
- IllegalArgumentException - if the {@code setPrecision} parameter is less than zero.

public MathContext (int setPrecision, RoundingMode setRoundingMode)

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

Constructs a new MathContext with a specified
precision and rounding mode.
Parameters:
- setPrecision - The non-negative {@code int} precision setting.
- setRoundingMode - The rounding mode to use.
Throws:
- IllegalArgumentException - if the {@code setPrecision} parameter is less than zero.
- NullPointerException - if the rounding mode argument is {@code null}

public MathContext (String val)

Constructs a new MathContext from a string.

Constructs a new MathContext from a string. The string must be in the same format as that produced by the MathContext.toString() method.

An IllegalArgumentException is thrown if the precision section of the string is out of range (< 0) or the string is not in the format created by the MathContext.toString() method.
Parameters:
- val - The string to be parsed
Throws:
- IllegalArgumentException - if the precision section is out of range or of incorrect format
- NullPointerException - if the argument is {@code null}

Methods

Hide/Show inherited methods

public boolean equals (Object x)

Compares this MathContext with the specified Object for equality.

Compares this MathContext with the specified
Object for equality.
Returns: {@code true} if and only if the specified {@code Object} is a {@code MathContext} object which has exactly the same settings as this object
Parameters:
- x - {@code Object} to which this {@code MathContext} is to be compared.

public int getPrecision ()

Returns the precision setting.

Returns the precision setting.
This value is always non-negative.
Returns: an {@code int} which is the value of the {@code precision} setting

public RoundingMode getRoundingMode ()

Returns the roundingMode setting.

public int hashCode ()

Returns the hash code for this MathContext.

Returns the hash code for this MathContext.
Returns: hash code for this {@code MathContext}

public String toString ()

Returns the string representation of this MathContext.

Returns the string representation of this MathContext. The String returned represents the settings of the MathContext object as two space-delimited words (separated by a single space character, '\u0020', and with no leading or trailing white space), as follows:

The string "precision=", immediately followed by the value of the precision setting as a numeric string as if generated by the Integer.toString method.
The string "roundingMode=", immediately followed by the value of the roundingMode setting as a word. This word will be the same as the name of the corresponding public constant in the RoundingMode enum.

For example:

 precision=9 roundingMode=HALF_UP

Additional words may be appended to the result of toString in the future if more properties are added to this class.
Returns: a {@code String} representing the context settings

Fields

Hide/Show inherited fields

publicfinalstatic MathContext DECIMAL128

A MathContext object with a precision setting matching the IEEE 754R Decimal128 format, 34 digits, and a rounding mode of HALF_EVEN, the IEEE 754R default.

publicfinalstatic MathContext DECIMAL32

A MathContext object with a precision setting matching the IEEE 754R Decimal32 format, 7 digits, and a rounding mode of HALF_EVEN, the IEEE 754R default.

publicfinalstatic MathContext DECIMAL64

A MathContext object with a precision setting matching the IEEE 754R Decimal64 format, 16 digits, and a rounding mode of HALF_EVEN, the IEEE 754R default.

pack-privatefinal int precision

The number of digits to be used for an operation.

pack-privatetransient BigInteger roundingMax

Lookaside for the rounding points (the numbers which determine whether the coefficient of a number will require rounding).

Lookaside for the rounding points (the numbers which determine
whether the coefficient of a number will require rounding).
These will be present if precision > 0 and
precision <= MAX_LOOKASIDE. In this case they will share the
BigInteger int[] array. Note that the transients
cannot be final because they are reconstructed on
deserialization.

pack-privatetransient BigInteger roundingMin

pack-privatefinal RoundingMode roundingMode

The rounding algorithm to be used for an operation.

publicfinalstatic MathContext UNLIMITED

A MathContext object whose settings have the values required for unlimited precision arithmetic.

A MathContext object whose settings have the values
required for unlimited precision arithmetic.
The values of the settings are:


  precision=0 roundingMode=HALF_UP