|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.math.MathContext
public final class 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:
RoundingMode object which specifies the algorithm to be
used for rounding.
BigDecimal,
RoundingMode,
Serialized Form| Field Summary | |
|---|---|
static 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. |
static 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. |
static 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. |
static MathContext |
UNLIMITED
A MathContext object whose settings have the values required for unlimited precision arithmetic. |
| Constructor Summary | |
|---|---|
MathContext(int setPrecision)
Constructs a new MathContext with the specified precision and the HALF_UP rounding
mode. |
|
MathContext(int setPrecision,
RoundingMode setRoundingMode)
Constructs a new MathContext with a specified precision and rounding mode. |
|
MathContext(String val)
Constructs a new MathContext from a string. |
|
| Method Summary | |
|---|---|
boolean |
equals(Object x)
Compares this MathContext with the specified Object for equality. |
int |
getPrecision()
Returns the precision setting. |
RoundingMode |
getRoundingMode()
Returns the roundingMode setting. |
int |
hashCode()
Returns the hash code for this MathContext. |
String |
toString()
Returns the string representation of this MathContext. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
public static final MathContext UNLIMITED
precision=0 roundingMode=HALF_UP
public static final MathContext DECIMAL32
HALF_EVEN, the
IEEE 754R default.
public static final MathContext DECIMAL64
HALF_EVEN, the
IEEE 754R default.
public static final MathContext DECIMAL128
HALF_EVEN, the
IEEE 754R default.
| Constructor Detail |
|---|
public MathContext(int setPrecision)
HALF_UP rounding
mode.
setPrecision - The non-negative int precision setting.
IllegalArgumentException - setPrecision parameter less
than zero.
public MathContext(int setPrecision,
RoundingMode setRoundingMode)
setPrecision - The non-negative int precision setting.setRoundingMode - The rounding mode to use.
IllegalArgumentException - setPrecision parameter less
than zero.public MathContext(String val)
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 - precision parameter out of range
or incorrect format| Method Detail |
|---|
public int getPrecision()
public RoundingMode getRoundingMode()
RoundingMode.CEILING,
RoundingMode.DOWN,
RoundingMode.FLOOR,
RoundingMode.HALF_DOWN,
RoundingMode.HALF_EVEN,
RoundingMode.HALF_UP,
RoundingMode.UNNECESSARY, or
RoundingMode.UP.
public boolean equals(Object x)
equals in class Objectx - Object to which this MathContext is to
be compared.
Object.hashCode(),
Hashtablepublic int hashCode()
hashCode in class ObjectObject.equals(java.lang.Object),
Hashtablepublic String toString()
Integer.toString
method.
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.
toString in class Object
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.