Rechnen

Rechnen

DIV

---

ADD

Script-Funktion: Führt eine Addition aus.

Syntax

ADD(Operand1, Operand2)

Kommentare

Die Script-Funktion addiert Operand1 und Operand2. Die zurückgegebenen Werte sind 16-stellige, alphanumerische Bedingungen (Strings) mit führenden Nullen.

Operand1 und Operand2 müssen Ausdrücke sein, welche Zahlen im erlaubten Wertebereich der Datentypen entsprechen. Das Ergebnis darf diesen Bereich ebenfalls nicht überschreiten.

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 mit dem Sprachmittel :DEFINE festgelegt. 

Es zählt immer der Datentyp des Ergebnis, nicht jener der Operanden! Ein negativer und positiver Operand kann 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.

Beispiele

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

:SET &RESULT# = ADD(1000,333)

In diesem Beispiel wird die Funktion verwendet, um eine Bedingung zu formulieren.

:SET &MAXIMUM# = 3000
:SET &RUN1# = 5000
:SET &RUN2# = 2000 
!...
:IF ADD(&RUN1#,&RUN2#) > &MAXIMUM#  
!... 
:ENDIF

The following example adds up two floating-point numbers.

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

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 +0000000000000004.8600000000000000

Eine weitere Möglichkeit für die Addition

Eine weitere Möglichkeit für die Addition wird unten dargestellt. In diesem Beispiel ist der Wert einer Script-Variable auf die Summe aus 1 plus 1 festgelegt.

:SET &ADD# = 1 + 1
:P &ADD#

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 0000000000000002

Siehe auch:

Script-Sprachmittel - Rechnen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Objekte lesen oder verändern