public final class MathContext extends Object implements Serializable
BigDecimal
.Modifier and Type | Field and Description |
---|---|
static MathContext |
DECIMAL128
A
MathContext which corresponds to the IEEE 754 quadruple
decimal precision format: 34 digit precision and
RoundingMode.HALF_EVEN rounding. |
static MathContext |
DECIMAL32
A
MathContext which corresponds to the IEEE 754 single decimal
precision format: 7 digit precision and RoundingMode.HALF_EVEN
rounding. |
static MathContext |
DECIMAL64
A
MathContext which corresponds to the IEEE 754 double decimal
precision format: 16 digit precision and RoundingMode.HALF_EVEN
rounding. |
static MathContext |
UNLIMITED
A
MathContext for unlimited precision with
RoundingMode.HALF_UP rounding. |
Constructor and Description |
---|
MathContext(int precision)
Constructs a new
MathContext with the specified precision and
with the rounding mode HALF_UP . |
MathContext(int precision,
RoundingMode roundingMode)
Constructs a new
MathContext with the specified precision and
with the specified rounding mode. |
MathContext(String s)
Constructs a new
MathContext from a string. |
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object x)
Returns true if x is a
MathContext with the same precision
setting and the same rounding mode as this MathContext instance. |
int |
getPrecision()
Returns the precision.
|
RoundingMode |
getRoundingMode()
Returns the rounding mode.
|
int |
hashCode()
Returns the hash code for this
MathContext instance. |
String |
toString()
Returns the string representation for this
MathContext instance. |
public static final MathContext DECIMAL128
MathContext
which corresponds to the IEEE 754 quadruple
decimal precision format: 34 digit precision and
RoundingMode.HALF_EVEN
rounding.public static final MathContext DECIMAL32
MathContext
which corresponds to the IEEE 754 single decimal
precision format: 7 digit precision and RoundingMode.HALF_EVEN
rounding.public static final MathContext DECIMAL64
MathContext
which corresponds to the IEEE 754 double decimal
precision format: 16 digit precision and RoundingMode.HALF_EVEN
rounding.public static final MathContext UNLIMITED
MathContext
for unlimited precision with
RoundingMode.HALF_UP
rounding.public MathContext(int precision)
MathContext
with the specified precision and
with the rounding mode HALF_UP
. If the
precision passed is zero, then this implies that the computations have to
be performed exact, the rounding mode in this case is irrelevant.precision
- the precision for the new MathContext
.IllegalArgumentException
- if precision < 0
.public MathContext(int precision, RoundingMode roundingMode)
MathContext
with the specified precision and
with the specified rounding mode. If the precision passed is zero, then
this implies that the computations have to be performed exact, the
rounding mode in this case is irrelevant.precision
- the precision for the new MathContext
.roundingMode
- the rounding mode for the new MathContext
.IllegalArgumentException
- if precision < 0
.NullPointerException
- if roundingMode
is null
.public MathContext(String s)
MathContext
from a string. The string has to
specify the precision and the rounding mode to be used and has to follow
the following syntax: "precision=<precision> roundingMode=<roundingMode>"
This is the same form as the one returned by the toString()
method.IllegalArgumentException
- if the string is not in the correct format or if the
precision specified is < 0.public int getPrecision()
public RoundingMode getRoundingMode()
The rounding mode is one of
RoundingMode.UP
,
RoundingMode.DOWN
,
RoundingMode.CEILING
,
RoundingMode.FLOOR
,
RoundingMode.HALF_UP
,
RoundingMode.HALF_DOWN
,
RoundingMode.HALF_EVEN
, or
RoundingMode.UNNECESSARY
.
public boolean equals(Object x)
MathContext
with the same precision
setting and the same rounding mode as this MathContext
instance.equals
in class Object
x
- object to be compared.true
if this MathContext
instance is equal to the
x
argument; false
otherwise.Object.hashCode()
,
HashMap
public int hashCode()
MathContext
instance.hashCode
in class Object
MathContext
.Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public String toString()
MathContext
instance.
The string has the form
"precision=<precision> roundingMode=<roundingMode>"
where <precision>
is an integer describing the number
of digits used for operations and <roundingMode>
is the
string representation of the rounding mode.