ADD
Die ADD-Scriptfunktion gibt die Summe zweier Werte als 16-stellige alphanumerische Zeichenkette mit führenden Nullen zurück. Die ADD-Funktion ist eine von mehreren arithmetischen Funktionen, mit denen Sie Berechnungen in Ihren Scripten durchführen können.
Syntax
ADD (Operand1, Operand2)
Parameter
- ADD
Scriptfunktion, die Operand1 und Operand2 hinzufügt
Rückgabewert: Ergebnis der Addition - Operand1
Erster Ausdruck
Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata - Operand2
Zweiter Ausdruck
Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata
Hinweise:
- Stellen Sie sicher, dass die Werte innerhalb des zulässigen Bereichs für die deklarierten Datentypen Ihrer Script-Variablen liegen. Entscheidend ist der Datentyp des Ergebnisses, nicht der Datentyp des Operanden. Nicht alle Datentypen unterstützen negative Werte und Dezimalstellen. Negative Werte führen zu einem Fehler, wenn die Variable nicht vom Datentyp float ist. Wenn der Datentyp der Variable keine Dezimalstellen erlaubt, werden Dezimalstellen der Ergebnisse abgeschnitten. Weitere Informationen finden Sie unter Datentypen von Script-Variablen.
- Die Ergebnisse werden im 16-stelligen Standardformat mit führenden Nullen zurückgeliefert. Gleitkommazahlen beinhalten auch 16 Dezimalstellen. Wenn negative Zahlen unterstützt werden, wird als erstes Zeichen ein Vorzeichen (+ oder -) verwendet.
TIPP: Sie können führende Nullen entfernen und andernfalls das Format der Ergebnisse mit der Script-Funktion FORMAT editieren.
Beispiele
Das folgende Beispiel speichert das Ergebnis einer arithmetischen Operation, die zwei Werte in einer Scriptvariablen addiert. Die Angabe von Operand1 und Operand2 erfolgt als numerischer Ausdruck.
:SET &RESULT# = ADD(1000,333)
Im folgenden Beispiel wird die ADD-Script-Funktion verwendet, um eine Bedingung zu formulieren:
:SET &MAXIMUM# = 3000
:SET &RUN1# = 5000
:SET &RUN2# = 2000
!...
:IF ADD(&RUN1#,&RUN2#) > &MAXIMUM#
!...
:ENDIF
Das folgende Beispiel fügt zwei Gleitkommazahlen hinzu:
:DEFINE &RESULT#,float
:SET &RESULT# = ADD(10.31,-5.45)
:P &RESULT#
Das folgende Ergebnis wird im Aktivierungsreport ausgegeben:
U0020408 +0000000000000004.8600000000000000
Das folgende Beispiel zeigt eine weitere Möglichkeit, Zahlen hinzuzufügen, indem man den Wert einer Variablen mit einem arithmetischen Ausdruck setzt:
:SET &ADD# = 1 + 1
:P &ADD#
Das folgende Ergebnis wird im Aktivierungsreport ausgegeben:
U0020408 0000000000000002
Siehe auch: