RANDOM

Rechnen

Strings

---

SUB

Script-Funktion: Führt eine Subtraktion aus.

Syntax

SUB(Operand1, Operand2)

Kommentare

Die Script-Funktion subtrahiert Operand2 von Operand1.

Operand1 und Operand2 müssen Ausdrücke sein, welche Zahlen im erlaubten Wertebereich der Datentypen entsprechen. Das Ergebnis darf diesen Bereich nicht überschreiten. Der Operand2 darf nicht Null sein. Wird das Ergebnis einer Script-Variable zugewiesen, muss diese den entsprechenden Datentyp aufweisen. Beim Versuch eine negative Zahl in eine Variable mit dem Datentyp "unsigned" zu speichern, kommt es zu einem Fehler. Handelt es sich beim Ergebnis um eine Gleitkommazahl und die Zielvariable besitzt den Datentyp "signed" oder "unsigned", so werden die Nachkommastellen abgeschnitten. Der Datentyp "float" unterstützt sowohl negative Zahlen als auch Gleitkommazahlen. Weiters ist auch der Datentyp "string" möglich, wobei das Ergebnis nicht als Zahl, sondern als Zeichenkette abgelegt wird. Der Datentyp von Script-Variablen wird bei der Definition mit dem Sprachmittel :DEFINE festgelegt.  

Es zählt immer der Datentyp des Ergebnis, nicht jener der Operanden! Ist beispielsweise Operand2 negativ, kann sich eine positive Zahl ergeben, die wiederum in eine Ziel-Variable mit dem Datentyp "unsigned" gespeichert werden kann.

Beachten Sie, dass es bei Rechenoperationen mit Gleitkommazahlen zu einem ungenauen Ergebnis kommen kann!

Das Ergebnis wird im 16-stelligen Standardformat zurückgeliefert. Gleitkommazahlen besitzen zusätzlich 16 Nachkommastellen und wenn negative Zahlen unterstützt werden, steht das entsprechende Vorzeichen (+ oder -) an erster Stelle. Um die Formatierung zu ändern verwenden Sie die Script-Funktion FORMAT.

Beispiel

Im Beispiel wird das Ergebnis der Rechenoperation an eine Script-Variable übergeben. Die Angabe von Operand1 und Operand2 erfolgt als numerischer Ausdruck.

:SET &RESULT# = SUB(1000,999)

The following example shows a subtraction with floating-point numbers. 

:DEFINE &RESULT#,float
:SET &RESULT# = SUB(10.31,-5.45)
:P &RESULT#

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 +0000000000000015.7600000000000000

Eine weitere Möglichkeit für eine Subtraktion

Eine weitere Möglichkeit für eine Subtraktion wird im Folgenden gezeigt. In diesem Beispiel ist der Wert einer Script-Variable auf das Ergebnis aus 3 minus 2 festgelegt.

:SET &SUBTRACT# = 3 - 2
:P &SUBTRACT#

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 0000000000000001

Siehe auch:

Script-Sprachmittel - Rechnen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung