java.lang.Object | |
↳ | java.math.MathContext |
Immutable objects which encapsulate the context settings which
describe certain rules for numerical operators, such as those
implemented by the BigDecimal
class.
The base-independent settings are:
precision
:
the number of digits to be used for an operation; results are
rounded to this precision
roundingMode
:
a RoundingMode
object which specifies the algorithm to be
used for rounding.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
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. |
||||||||||
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. |
||||||||||
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. |
||||||||||
UNLIMITED | A MathContext object whose settings have the values
required for unlimited precision arithmetic. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new
MathContext with the specified
precision and the HALF_UP rounding
mode. | |||||||||||
Constructs a new
MathContext with a specified
precision and rounding mode. | |||||||||||
Constructs a new
MathContext from a string. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Compares this
MathContext with the specified
Object for equality. | |||||||||||
Returns the
precision setting. | |||||||||||
Returns the roundingMode setting.
| |||||||||||
Returns the hash code for this
MathContext . | |||||||||||
Returns the string representation of this
MathContext . |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
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.
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.
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.
A MathContext
object whose settings have the values
required for unlimited precision arithmetic.
The values of the settings are:
precision=0 roundingMode=HALF_UP
Constructs a new MathContext
with the specified
precision and the HALF_UP
rounding
mode.
setPrecision | The non-negative int precision setting. |
---|
IllegalArgumentException | if the setPrecision parameter is less
than zero.
|
---|
Constructs a new MathContext
with a specified
precision and rounding mode.
setPrecision | The non-negative int precision setting. |
---|---|
setRoundingMode | The rounding mode to use. |
IllegalArgumentException | if the setPrecision parameter is less
than zero. |
---|---|
NullPointerException | if the rounding mode argument is null
|
Constructs a new MathContext
from a string.
The string must be in the same format as that produced by the
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 toString()
method.
val | The string to be parsed |
---|
IllegalArgumentException | if the precision section is out of range or of incorrect format |
---|---|
NullPointerException | if the argument is null
|
Compares this MathContext
with the specified
Object
for equality.
x | Object to which this MathContext is to
be compared. |
---|
true
if and only if the specified Object
is
a MathContext
object which has exactly the same
settings as this object
Returns the precision
setting.
This value is always non-negative.
int
which is the value of the precision
setting
Returns the hash code for this MathContext
.
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:
"precision="
, immediately followed
by the value of the precision setting as a numeric string as if
generated by the Integer.toString
method.
"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_UPAdditional words may be appended to the result of
toString
in the future if more properties are added to
this class.String
representing the context settings