International Components for Unicode for Java (icu4j) 74.2 · com.ibm.icu.math.MathContext

The MathContext immutable class encapsulates the settings understood by the operator methods of the BigDecimal class (and potentially other classes). Operator methods are those that effect an operation on a number or a pair of numbers.

The settings, which are not base-dependent, comprise:

digits: the number of digits (precision) to be used for an operation
form: the form of any exponent that results from the operation
lostDigits: whether checking for lost digits is enabled
roundingMode: the algorithm to be used for rounding.

When provided, a MathContext object supplies the settings for an operation directly.

When MathContext.DEFAULT is provided for a MathContext parameter then the default settings are used (9, SCIENTIFIC, false, ROUND_HALF_UP).

In the BigDecimal class, all methods which accept a MathContext object defaults) also have a version of the method which does not accept a MathContext parameter. These versions carry out unlimited precision fixed point arithmetic (as though the settings were (0, PLAIN, false, ROUND_HALF_UP).

The instance variables are shared with default access (so they are directly accessible to the BigDecimal class), but must never be changed.

The rounding mode constants have the same names and values as the constants of the same name in java.math.BigDecimal, to maintain compatibility with earlier versions of BigDecimal.

Field Summary

Modifier and Type	Field and Description
public static final MathContext	DEFAULT A `MathContext` object initialized to the default settings for general-purpose arithmetic.
private static final int	DEFAULT_DIGITS
private static final int	DEFAULT_FORM
private static final boolean	DEFAULT_LOSTDIGITS
private static final int	DEFAULT_ROUNDINGMODE
pack-priv int	digits The number of digits (precision) to be used for an operation.
public static final int	ENGINEERING Standard floating point notation (with engineering exponential format, where the power of ten is a multiple of 3).
pack-priv int	form The form of results from an operation.
pack-priv boolean	lostDigits Controls whether lost digits checking is enabled for an operation.
private static final int	MAX_DIGITS
private static final int	MIN_DIGITS
public static final int	PLAIN Plain (fixed point) notation, without any exponent.
public static final int	ROUND_CEILING Rounding mode to round to a more positive number.
public static final int	ROUND_DOWN Rounding mode to round towards zero.
public static final int	ROUND_FLOOR Rounding mode to round to a more negative number.
public static final int	ROUND_HALF_DOWN Rounding mode to round to nearest neighbor, where an equidistant value is rounded down.
public static final int	ROUND_HALF_EVEN Rounding mode to round to nearest neighbor, where an equidistant value is rounded to the nearest even neighbor.
public static final int	ROUND_HALF_UP Rounding mode to round to nearest neighbor, where an equidistant value is rounded up.
public static final int	ROUND_UNNECESSARY Rounding mode to assert that no rounding is necessary.
public static final int	ROUND_UP Rounding mode to round away from zero.
pack-priv int	roundingMode The rounding algorithm to be used for an operation.
private static final int[]	ROUNDS
private static final String[]	ROUNDWORDS
public static final int	SCIENTIFIC Standard floating point notation (with scientific exponential format, where there is one digit before any decimal point).
private static final long	serialVersionUID

Constructor Summary

Access	Constructor and Description
public	MathContext(int The `int` digits setting for this `MathContext`. setdigits) Constructs a new `MathContext` with a specified precision.
public	MathContext(int The `int` digits setting for this `MathContext`. setdigits, int The `int` form setting for this `MathContext`. setform) Constructs a new `MathContext` with a specified precision and form.
public	MathContext(int The `int` digits setting for this `MathContext`. setdigits, int The `int` form setting for this `MathContext`. setform, boolean The `boolean` lostDigits setting for this `MathContext`. setlostdigits) Constructs a new `MathContext` with a specified precision, form, and lostDigits setting.
public	MathContext(int The `int` digits setting for this `MathContext`. setdigits, int The `int` form setting for this `MathContext`. setform, boolean The `boolean` lostDigits setting for this `MathContext`. setlostdigits, int The `int` roundingMode setting for this `MathContext`. setroundingmode) Constructs a new `MathContext` with a specified precision, form, lostDigits, and roundingMode setting.

Method Summary

Modifier and Type	Method and Description
public int	Returns: an `int` which is the value of the digits setting getDigits() Returns the digits setting.
public int	Returns: an `int` which is the value of the form setting getForm() Returns the form setting.
public boolean	Returns: a `boolean` which is the value of the lostDigits setting getLostDigits() Returns the lostDigits setting.
public int	Returns: an `int` which is the value of the roundingMode setting getRoundingMode() Returns the roundingMode setting.
private static boolean	isValidRound(int testround)
public String	Returns: a `String` representing the context settings. toString() Overrides java.lang.Object.toString. Returns the `MathContext` as a readable string.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

DEFAULT back to summary

DEFAULT	back to summary
public static final MathContext DEFAULT A `MathContext` object initialized to the default settings for general-purpose arithmetic. That is, `digits=9 form=SCIENTIFIC lostDigits=false roundingMode=ROUND_HALF_UP`. ICU Status Stable since ICU 2.0. See Also `SCIENTIFIC`, `ROUND_HALF_UP`

public static final MathContext DEFAULT

A MathContext object initialized to the default settings for general-purpose arithmetic. That is, digits=9 form=SCIENTIFIC lostDigits=false roundingMode=ROUND_HALF_UP.

ICU Status: Stable since ICU 2.0.
See Also: SCIENTIFIC, ROUND_HALF_UP

DEFAULT_DIGITS	back to summary
private static final int DEFAULT_DIGITS

DEFAULT_FORM	back to summary
private static final int DEFAULT_FORM

DEFAULT_LOSTDIGITS	back to summary
private static final boolean DEFAULT_LOSTDIGITS

DEFAULT_ROUNDINGMODE	back to summary
private static final int DEFAULT_ROUNDINGMODE

digits back to summary

digits	back to summary
pack-priv int digits The number of digits (precision) to be used for an operation. A value of 0 indicates that unlimited precision (as many digits as are required) will be used. The `BigDecimal` operator methods use this value to determine the precision of results. Note that leading zeros (in the integer part of a number) are never significant. `digits` will always be non-negative.

pack-priv int digits

The number of digits (precision) to be used for an operation. A value of 0 indicates that unlimited precision (as many digits as are required) will be used.

The BigDecimal operator methods use this value to determine the precision of results. Note that leading zeros (in the integer part of a number) are never significant.

digits will always be non-negative.

ENGINEERING back to summary

ENGINEERING	back to summary
public static final int ENGINEERING Standard floating point notation (with engineering exponential format, where the power of ten is a multiple of 3). Used as a setting to control the form of the result of a `BigDecimal` operation. A zero result in plain form may have a decimal part of one or more zeros. ICU Status Stable since ICU 2.0. See Also `PLAIN`, `SCIENTIFIC`

public static final int ENGINEERING

Standard floating point notation (with engineering exponential format, where the power of ten is a multiple of 3). Used as a setting to control the form of the result of a BigDecimal operation. A zero result in plain form may have a decimal part of one or more zeros.

ICU Status: Stable since ICU 2.0.
See Also: PLAIN, SCIENTIFIC

form back to summary

form	back to summary
pack-priv int form The form of results from an operation. The `BigDecimal` operator methods use this value to determine the form of results, in particular whether and how exponential notation should be used. See Also `ENGINEERING`, `PLAIN`, `SCIENTIFIC`

pack-priv int form

The form of results from an operation.

The BigDecimal operator methods use this value to determine the form of results, in particular whether and how exponential notation should be used.

See Also: ENGINEERING, PLAIN, SCIENTIFIC

lostDigits back to summary

lostDigits	back to summary
pack-priv boolean lostDigits Controls whether lost digits checking is enabled for an operation. Set to `true` to enable checking, or to `false` to disable checking. When enabled, the `BigDecimal` operator methods check the precision of their operand or operands, and throw an `ArithmeticException` if an operand is more precise than the digits setting (that is, digits would be lost). When disabled, operands are rounded to the specified digits.

pack-priv boolean lostDigits

Controls whether lost digits checking is enabled for an operation. Set to true to enable checking, or to false to disable checking.

When enabled, the BigDecimal operator methods check the precision of their operand or operands, and throw an ArithmeticException if an operand is more precise than the digits setting (that is, digits would be lost). When disabled, operands are rounded to the specified digits.

MAX_DIGITS	back to summary
private static final int MAX_DIGITS

MIN_DIGITS	back to summary
private static final int MIN_DIGITS

PLAIN back to summary

PLAIN	back to summary
public static final int PLAIN Plain (fixed point) notation, without any exponent. Used as a setting to control the form of the result of a `BigDecimal` operation. A zero result in plain form may have a decimal part of one or more zeros. ICU Status Stable since ICU 2.0. See Also `ENGINEERING`, `SCIENTIFIC`

public static final int PLAIN

Plain (fixed point) notation, without any exponent. Used as a setting to control the form of the result of a BigDecimal operation. A zero result in plain form may have a decimal part of one or more zeros.

ICU Status: Stable since ICU 2.0.
See Also: ENGINEERING, SCIENTIFIC

ROUND_CEILING back to summary

ROUND_CEILING	back to summary
public static final int ROUND_CEILING Rounding mode to round to a more positive number. Used as a setting to control the rounding mode used during a `BigDecimal` operation. If any of the discarded digits are non-zero then the result should be rounded towards the next more positive digit. ICU Status Stable since ICU 2.0.

public static final int ROUND_CEILING

Rounding mode to round to a more positive number. Used as a setting to control the rounding mode used during a BigDecimal operation.

If any of the discarded digits are non-zero then the result should be rounded towards the next more positive digit.

ICU Status: Stable since ICU 2.0.

ROUND_DOWN back to summary

ROUND_DOWN	back to summary
public static final int ROUND_DOWN Rounding mode to round towards zero. Used as a setting to control the rounding mode used during a `BigDecimal` operation. All discarded digits are ignored (truncated). The result is neither incremented nor decremented. ICU Status Stable since ICU 2.0.

public static final int ROUND_DOWN

Rounding mode to round towards zero. Used as a setting to control the rounding mode used during a BigDecimal operation.

All discarded digits are ignored (truncated). The result is neither incremented nor decremented.

ICU Status: Stable since ICU 2.0.

ROUND_FLOOR back to summary

ROUND_FLOOR	back to summary
public static final int ROUND_FLOOR Rounding mode to round to a more negative number. Used as a setting to control the rounding mode used during a `BigDecimal` operation. If any of the discarded digits are non-zero then the result should be rounded towards the next more negative digit. ICU Status Stable since ICU 2.0.

public static final int ROUND_FLOOR

Rounding mode to round to a more negative number. Used as a setting to control the rounding mode used during a BigDecimal operation.

If any of the discarded digits are non-zero then the result should be rounded towards the next more negative digit.

ICU Status: Stable since ICU 2.0.

ROUND_HALF_DOWN back to summary

ROUND_HALF_DOWN	back to summary
public static final int ROUND_HALF_DOWN Rounding mode to round to nearest neighbor, where an equidistant value is rounded down. Used as a setting to control the rounding mode used during a `BigDecimal` operation. If the discarded digits represent greater than half (0.5 times) the value of a one in the next position then the result should be rounded up (away from zero). Otherwise the discarded digits are ignored. ICU Status Stable since ICU 2.0.

public static final int ROUND_HALF_DOWN

Rounding mode to round to nearest neighbor, where an equidistant value is rounded down. Used as a setting to control the rounding mode used during a BigDecimal operation.

If the discarded digits represent greater than half (0.5 times) the value of a one in the next position then the result should be rounded up (away from zero). Otherwise the discarded digits are ignored.

ICU Status: Stable since ICU 2.0.

ROUND_HALF_EVEN back to summary

ROUND_HALF_EVEN	back to summary
public static final int ROUND_HALF_EVEN Rounding mode to round to nearest neighbor, where an equidistant value is rounded to the nearest even neighbor. Used as a setting to control the rounding mode used during a `BigDecimal` operation. If the discarded digits represent greater than half (0.5 times) the value of a one in the next position then the result should be rounded up (away from zero). If they represent less than half, then the result should be rounded down. Otherwise (they represent exactly half) the result is rounded down if its rightmost digit is even, or rounded up if its rightmost digit is odd (to make an even digit). ICU Status Stable since ICU 2.0.

public static final int ROUND_HALF_EVEN

Rounding mode to round to nearest neighbor, where an equidistant value is rounded to the nearest even neighbor. Used as a setting to control the rounding mode used during a BigDecimal operation.

If the discarded digits represent greater than half (0.5 times) the value of a one in the next position then the result should be rounded up (away from zero). If they represent less than half, then the result should be rounded down.

Otherwise (they represent exactly half) the result is rounded down if its rightmost digit is even, or rounded up if its rightmost digit is odd (to make an even digit).

ICU Status: Stable since ICU 2.0.

ROUND_HALF_UP back to summary

ROUND_HALF_UP	back to summary
public static final int ROUND_HALF_UP Rounding mode to round to nearest neighbor, where an equidistant value is rounded up. Used as a setting to control the rounding mode used during a `BigDecimal` operation. If the discarded digits represent greater than or equal to half (0.5 times) the value of a one in the next position then the result should be rounded up (away from zero). Otherwise the discarded digits are ignored. ICU Status Stable since ICU 2.0.

public static final int ROUND_HALF_UP

Rounding mode to round to nearest neighbor, where an equidistant value is rounded up. Used as a setting to control the rounding mode used during a BigDecimal operation.

If the discarded digits represent greater than or equal to half (0.5 times) the value of a one in the next position then the result should be rounded up (away from zero). Otherwise the discarded digits are ignored.

ICU Status: Stable since ICU 2.0.

ROUND_UNNECESSARY back to summary

ROUND_UNNECESSARY	back to summary
public static final int ROUND_UNNECESSARY Rounding mode to assert that no rounding is necessary. Used as a setting to control the rounding mode used during a `BigDecimal` operation. Rounding (potential loss of information) is not permitted. If any of the discarded digits are non-zero then an `ArithmeticException` should be thrown. ICU Status Stable since ICU 2.0.

public static final int ROUND_UNNECESSARY

Rounding mode to assert that no rounding is necessary. Used as a setting to control the rounding mode used during a BigDecimal operation.

Rounding (potential loss of information) is not permitted. If any of the discarded digits are non-zero then an ArithmeticException should be thrown.

ICU Status: Stable since ICU 2.0.

ROUND_UP back to summary

ROUND_UP	back to summary
public static final int ROUND_UP Rounding mode to round away from zero. Used as a setting to control the rounding mode used during a `BigDecimal` operation. If any of the discarded digits are non-zero then the result will be rounded up (away from zero). ICU Status Stable since ICU 2.0.

public static final int ROUND_UP

Rounding mode to round away from zero. Used as a setting to control the rounding mode used during a BigDecimal operation.

If any of the discarded digits are non-zero then the result will be rounded up (away from zero).

ICU Status: Stable since ICU 2.0.

roundingMode back to summary

roundingMode	back to summary
pack-priv int roundingMode The rounding algorithm to be used for an operation. The `BigDecimal` operator methods use this value to determine the algorithm to be used when non-zero digits have to be discarded in order to reduce the precision of a result. The value must be one of the public constants whose name starts with `ROUND_`. See Also `ROUND_CEILING`, `ROUND_DOWN`, `ROUND_FLOOR`, `ROUND_HALF_DOWN`, `ROUND_HALF_EVEN`, `ROUND_HALF_UP`, `ROUND_UNNECESSARY`, `ROUND_UP`

pack-priv int roundingMode

The rounding algorithm to be used for an operation.

The BigDecimal operator methods use this value to determine the algorithm to be used when non-zero digits have to be discarded in order to reduce the precision of a result. The value must be one of the public constants whose name starts with ROUND_.

See Also: ROUND_CEILING, ROUND_DOWN, ROUND_FLOOR, ROUND_HALF_DOWN, ROUND_HALF_EVEN, ROUND_HALF_UP, ROUND_UNNECESSARY, ROUND_UP

ROUNDS	back to summary
private static final int[] ROUNDS

ROUNDWORDS	back to summary
private static final String[] ROUNDWORDS

SCIENTIFIC back to summary

SCIENTIFIC	back to summary
public static final int SCIENTIFIC Standard floating point notation (with scientific exponential format, where there is one digit before any decimal point). Used as a setting to control the form of the result of a `BigDecimal` operation. A zero result in plain form may have a decimal part of one or more zeros. ICU Status Stable since ICU 2.0. See Also `ENGINEERING`, `PLAIN`

public static final int SCIENTIFIC

Standard floating point notation (with scientific exponential format, where there is one digit before any decimal point). Used as a setting to control the form of the result of a BigDecimal operation. A zero result in plain form may have a decimal part of one or more zeros.

ICU Status: Stable since ICU 2.0.
See Also: ENGINEERING, PLAIN

serialVersionUID	back to summary
private static final long serialVersionUID

Constructor Detail

MathContext back to summary

MathContext	back to summary
public MathContext(int setdigits) Constructs a new `MathContext` with a specified precision. The other settings are set to the default values (see `DEFAULT`). An `IllegalArgumentException` is thrown if the `setdigits` parameter is out of range (<0 or >999999999). Parameters setdigits:int The `int` digits setting for this `MathContext`. Exceptions IllegalArgumentException: parameter out of range. ICU Status Stable since ICU 2.0.

public MathContext(int setdigits)

Constructs a new MathContext with a specified precision. The other settings are set to the default values (see DEFAULT). An IllegalArgumentException is thrown if the setdigits parameter is out of range (<0 or >999999999).

Parameters

setdigits:int: The int digits setting for this MathContext.

Exceptions

IllegalArgumentException:: parameter out of range.

ICU Status

Stable since ICU 2.0.

MathContext back to summary

MathContext	back to summary
public MathContext(int setdigits, int setform) Constructs a new `MathContext` with a specified precision and form. The other settings are set to the default values (see `DEFAULT`). An `IllegalArgumentException` is thrown if the `setdigits` parameter is out of range (<0 or >999999999), or if the value given for the `setform` parameter is not one of the appropriate constants. Parameters setdigits:int The `int` digits setting for this `MathContext`. setform:int The `int` form setting for this `MathContext`. Exceptions IllegalArgumentException: parameter out of range. ICU Status Stable since ICU 2.0.

public MathContext(int setdigits, int setform)

Constructs a new MathContext with a specified precision and form. The other settings are set to the default values (see DEFAULT). An IllegalArgumentException is thrown if the setdigits parameter is out of range (<0 or >999999999), or if the value given for the setform parameter is not one of the appropriate constants.

Parameters

setdigits:int: The int digits setting for this MathContext.
setform:int: The int form setting for this MathContext.

Exceptions

IllegalArgumentException:: parameter out of range.

ICU Status

Stable since ICU 2.0.

MathContext back to summary

MathContext	back to summary
public MathContext(int setdigits, int setform, boolean setlostdigits) Constructs a new `MathContext` with a specified precision, form, and lostDigits setting. The roundingMode setting is set to its default value (see `DEFAULT`). An `IllegalArgumentException` is thrown if the `setdigits` parameter is out of range (<0 or >999999999), or if the value given for the `setform` parameter is not one of the appropriate constants. Parameters setdigits:int The `int` digits setting for this `MathContext`. setform:int The `int` form setting for this `MathContext`. setlostdigits:boolean The `boolean` lostDigits setting for this `MathContext`. Exceptions IllegalArgumentException: parameter out of range. ICU Status Stable since ICU 2.0.

public MathContext(int setdigits, int setform, boolean setlostdigits)

Constructs a new MathContext with a specified precision, form, and lostDigits setting. The roundingMode setting is set to its default value (see DEFAULT). An IllegalArgumentException is thrown if the setdigits parameter is out of range (<0 or >999999999), or if the value given for the setform parameter is not one of the appropriate constants.

Parameters

setdigits:int: The int digits setting for this MathContext.
setform:int: The int form setting for this MathContext.
setlostdigits:boolean: The boolean lostDigits setting for this MathContext.

Exceptions

IllegalArgumentException:: parameter out of range.

ICU Status

Stable since ICU 2.0.

MathContext back to summary

MathContext	back to summary
public MathContext(int setdigits, int setform, boolean setlostdigits, int setroundingmode) Constructs a new `MathContext` with a specified precision, form, lostDigits, and roundingMode setting. An `IllegalArgumentException` is thrown if the `setdigits` parameter is out of range (<0 or >999999999), or if the value given for the `setform` or `setroundingmode` parameters is not one of the appropriate constants. Parameters setdigits:int The `int` digits setting for this `MathContext`. setform:int The `int` form setting for this `MathContext`. setlostdigits:boolean The `boolean` lostDigits setting for this `MathContext`. setroundingmode:int The `int` roundingMode setting for this `MathContext`. Exceptions IllegalArgumentException: parameter out of range. ICU Status Stable since ICU 2.0.

public MathContext(int setdigits, int setform, boolean setlostdigits, int setroundingmode)

Constructs a new MathContext with a specified precision, form, lostDigits, and roundingMode setting. An IllegalArgumentException is thrown if the setdigits parameter is out of range (<0 or >999999999), or if the value given for the setform or setroundingmode parameters is not one of the appropriate constants.

Parameters

setdigits:int: The int digits setting for this MathContext.
setform:int: The int form setting for this MathContext.
setlostdigits:boolean: The boolean lostDigits setting for this MathContext.
setroundingmode:int: The int roundingMode setting for this MathContext.

Exceptions

IllegalArgumentException:: parameter out of range.

ICU Status

Stable since ICU 2.0.

Method Detail

getDigits back to summary

getDigits	back to summary
public int getDigits() Returns the digits setting. This value is always non-negative. Returns:int an `int` which is the value of the digits setting ICU Status Stable since ICU 2.0.

public int getDigits()

Returns the digits setting. This value is always non-negative.

Returns:int: an int which is the value of the digits setting
ICU Status: Stable since ICU 2.0.

getForm back to summary

getForm	back to summary
public int getForm() Returns the form setting. This will be one of `ENGINEERING`, `PLAIN`, or `SCIENTIFIC`. Returns:int an `int` which is the value of the form setting ICU Status Stable since ICU 2.0.

public int getForm()

Returns the form setting. This will be one of ENGINEERING, PLAIN, or SCIENTIFIC.

Returns:int: an int which is the value of the form setting
ICU Status: Stable since ICU 2.0.

getLostDigits back to summary

getLostDigits	back to summary
public boolean getLostDigits() Returns the lostDigits setting. This will be either `true` (enabled) or `false` (disabled). Returns:boolean a `boolean` which is the value of the lostDigits setting ICU Status Stable since ICU 2.0.

public boolean getLostDigits()

Returns the lostDigits setting. This will be either true (enabled) or false (disabled).

Returns:boolean: a boolean which is the value of the lostDigits setting
ICU Status: Stable since ICU 2.0.

getRoundingMode back to summary

getRoundingMode	back to summary
public int getRoundingMode() Returns the roundingMode setting. This will be one of `ROUND_CEILING`, `ROUND_DOWN`, `ROUND_FLOOR`, `ROUND_HALF_DOWN`, `ROUND_HALF_EVEN`, `ROUND_HALF_UP`, `ROUND_UNNECESSARY`, or `ROUND_UP`. Returns:int an `int` which is the value of the roundingMode setting ICU Status Stable since ICU 2.0.

public int getRoundingMode()

Returns the roundingMode setting. This will be one of ROUND_CEILING, ROUND_DOWN, ROUND_FLOOR, ROUND_HALF_DOWN, ROUND_HALF_EVEN, ROUND_HALF_UP, ROUND_UNNECESSARY, or ROUND_UP.

Returns:int: an int which is the value of the roundingMode setting
ICU Status: Stable since ICU 2.0.

isValidRound	back to summary
private static boolean isValidRound(int testround)

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Returns the `MathContext` as a readable string. The `String` returned represents the settings of the `MathContext` object as four blank-delimited words separated by a single blank and with no leading or trailing blanks, as follows: `digits=`, immediately followed by the value of the digits setting as a numeric word. `form=`, immediately followed by the value of the form setting as an uppercase word (one of `SCIENTIFIC`, `PLAIN`, or `ENGINEERING`). `lostDigits=`, immediately followed by the value of the lostDigits setting (`1` if enabled, `0` if disabled). `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. For example: `digits=9 form=SCIENTIFIC lostDigits=0 roundingMode=ROUND_HALF_UP` Additional words may be appended to the result of `toString` in the future if more properties are added to the class. Returns:String a `String` representing the context settings. Annotations @Override ICU Status Stable since ICU 2.0.

public String toString()

Overrides java.lang.Object.toString.

Returns the MathContext as a readable string. The String returned represents the settings of the MathContext object as four blank-delimited words separated by a single blank and with no leading or trailing blanks, as follows:

digits=, immediately followed by the value of the digits setting as a numeric word.
form=, immediately followed by the value of the form setting as an uppercase word (one of SCIENTIFIC, PLAIN, or ENGINEERING).
lostDigits=, immediately followed by the value of the lostDigits setting (1 if enabled, 0 if disabled).
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.

For example:
digits=9 form=SCIENTIFIC lostDigits=0 roundingMode=ROUND_HALF_UP

Additional words may be appended to the result of toString in the future if more properties are added to the class.

Returns:String

a String representing the context settings.

Annotations

@Override

ICU Status

Stable since ICU 2.0.

public final Class MathContext

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail