Start page
Start page

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

#mathContextAvailable from FirstSpirit Version 4.1.43

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.

© 2005 - 2014 e-Spirit AG | All rights reserved. | Last change: 2013-03-14