Startseite / Vorlagenentwicklung / Vorlagensyntax / Systemobjekte / #mathContext

#mathContextVerfügbar ab FirstSpirit-Version 4.1.43

Mithilfe des Systemobjekts #mathContext kann für die Division von Zahlen (z. B. $CMS_VALUE(100.0/33.0)$) die Berechnungsgenauigkeit und den Rundungsmodus konfiguriert werden.

Das Systemobjekt verfügt über die Methoden precision, roundingMode und useDefault.

Mit der Methode precision kann die Genauigkeit der Division beeinflusst werden. Als Wert kann eine Ganzzahl angegeben werden, die die Anzahl der Dezimalstellen für die Berechnung festlegt. Der Standardwert beträgt 32.

Beispiel:

$CMS_SET(#mathContext.precision, 3)$

Durch diese $CMS_SET(...)$-Anweisung wird die Anzahl der Dezimalstellen für die Berechnung auf 3 festgelegt.

Das Ergebnis von $CMS_VALUE(100.0/33.0)$ wäre damit

3.03

Mit der Methode roundingMode kann der Rundungsmodus festgelegt werden. Mögliche Werte sind:

  • UP
  • DOWN
  • CEILING
  • FLOOR
  • HALF_UP
  • HALF_DOWN
  • HALF_EVEN und
  • UNNECESSARY

Als Standardwert wird HALF_UP verwendet.
Die Beschreibung der einzelnen Rundungsverfahren können der allgemeinen Java-API-Dokumentation entnommen werden:
RoundingMode

Beispiel:

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

Durch diese $CMS_SET(...)$-Anweisung wird der Rundungsmodus auf den Wert UP festgelegt.

Das Ergebnis von $CMS_VALUE(100.0/33.0)$ wäre damit

3.0303030303030303030303030303031

Die Berechnungsgenauigkeit und der Rundungsmodus kann mit der Methode useDefault auf die Standardwerte zurückgesetzt werden:

$CMS_SET(_void, #mathContext.useDefault)$

Siehe dazu auch Datentyp Number.

© 2005 - 2024 Crownpeak Technology GmbH | Alle Rechte vorbehalten. | FirstSpirit 2024.4 | Datenschutz