java.math
public
final
class
java.math.MathContext
Immutable objects describing settings as rounding mode and digit precision
for the numerical operations provided by class BigDecimal
.
Summary
Constants
|
|
|
Value |
|
MathContext |
DECIMAL128 |
A MathContext wich corresponds to the IEEE 754r quadruple decimal precision format:
34 digit preicision and HALF_EVEN rounding. |
|
|
MathContext |
DECIMAL32 |
A MathContext wich corresponds to the IEEE 754r single decimal precision format:
7 digit preicision and HALF_EVEN rounding. |
|
|
MathContext |
DECIMAL64 |
A MathContext wich corresponds to the IEEE 754r double decimal precision format:
16 digit preicision and HALF_EVEN rounding. |
|
|
MathContext |
UNLIMITED |
A MathContext for unlimited precision with HALF_UP rounding. |
|
|
Public Constructors
Public Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Constants
public
static
final
MathContext
DECIMAL128
A MathContext wich corresponds to the IEEE 754r quadruple decimal precision format:
34 digit preicision and HALF_EVEN rounding.
public
static
final
MathContext
DECIMAL32
A MathContext wich corresponds to the IEEE 754r single decimal precision format:
7 digit preicision and HALF_EVEN rounding.
public
static
final
MathContext
DECIMAL64
A MathContext wich corresponds to the IEEE 754r double decimal precision format:
16 digit preicision and HALF_EVEN rounding.
public
static
final
MathContext
UNLIMITED
A MathContext for unlimited precision with HALF_UP rounding.
Public Constructors
public
MathContext(int precision)
Constructs a new 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.
Parameters
precision
| the precision for the new MathContext |
public
MathContext(int precision, RoundingMode roundingMode)
Constructs a new 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.
Parameters
precision
| the precision for the new MathContext |
roundingMode
| the rounding mode for the new MathContext |
public
MathContext(String val)
Constructs a new 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=
roundingMode="
This is the same form as the one returned by the toString() method.
Parameters
val
| a string describing the precision and rounding mode for the new MathContext. |
Public Methods
public
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.
Returns
- true if this MathContext instance is equal to the x argument; false otherwise.
public
int
getPrecision()
Returns the precision. The precision is the number of digits used
for an operation. Results are rounded to this precision. The precision
is guaranteed to be non negative. If the precision is zero, then
the computations have to be performed exact, results are not rounded
in this case.
public
RoundingMode
getRoundingMode()
Returns the rounding mode. The rounding mode is the strategy to be
used to round results. The rounding mode is one of RoundingMode.UP,
RoundingMode.DOWN, RoundingMode.CEILING, RoundingMode.FLOOR,
RoundingMode.HALF_UP, RoundingMode.HALF_DOWN, RoundingMode.HALF_EVEN,
or oundingMode.UNNECESSARY.
public
int
hashCode()
Returns the hash code for this MathContext instance.
Returns
- the hash code for this MathContext
public
String
toString()
Returns the string representation for this MathContext instance.
The string has the form
"precision=
roundingMode="
where is an int describing the number of digits used for
operations and is the string representation of the
rounding mode.
Returns
- a string representation for this MathContext instance.