Start page / Template development / Template syntax / System objects / #mathContext

#mathContext

Using the #mathContext system object, the calculation accuracy and rounding mode can be configured for the division of numbers (e.g. $CMS_VALUE(100.0/33.0)$).

The system object features the precision, roundingMode and useDefault methods.

The division accuracy can be influenced using the precision method. An integer can be entered as the value which specifies the number of decimal places for the calculation. The default value is 32.

Example:

$CMS_SET(#mathContext.precision, 3)$

The number of decimal places is set to 3 for the calculation using this $CMS_SET(...)$ instruction.

The result of $CMS_VALUE(100.0/33.0)$ would thus be

3.03

The rounding mode can be specified using the roundingMode method. The following are possible values:

UP
DOWN
CEILING
FLOOR
HALF_UP
HALF_DOWN
HALF_EVEN and
UNNECESSARY

HALF_UP is used as the default value.
The description of individual rounding modes can be found in the general Java API documentation:
RoundingMode

Example:

$CMS_SET(#mathContext.roundingMode, "UP")$

Using this $CMS_SET(...)$ instruction, the rounding mode is set to the value UP.

The result of $CMS_VALUE(100.0/33.0)$ would thus be

3.0303030303030303030303030303031

The calculation accuracy and rounding mode can be reset to the default values using the useDefault method:

$CMS_SET(_void, #mathContext.useDefault)$

For more information, see also Number data type.

Print version | Page start