ADD

Verwenden Sie die Script-Funktion ADD, um die Summe zweier Werte als 16-stelligen alphanumerischen String mit führenden Nullen zurückzugeben.

Syntax

ADD (Operand1, Operand2)

Parameter

• ADD
  Script-Funktion, die Operand1 und Operand2 addiert

• Operand1
  Erster Ausdruck
  Format: Script-Literal, Script-Variable oder Zahl ohne Anführungszeichen

• Operand2
  Zweiter Ausdruck
  Format: Script-Literal, Script-Variable oder Zahl ohne Anführungszeichen

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.
• Wenn das Ergebnis eine Gleitkommazahl ist und die Zielvariable ein Datentyp mit oder ohne Vorzeichen ist, werden die Dezimalzahlen auf die nächste ganze Zahl aufgerundet oder abgerundet.

Tipp: Sie können führende Nullen entfernen und andernfalls das Format der Ergebnisse mit der Script-Funktion FORMAT editieren.

Rückgabewert

Die Script-Funktion gibt das Ergebnis der Addition zurück.

Beispiele

Das folgende Beispiel speichert das Ergebnis einer arithmetischen Operation, die zwei Werte in einer Script-Variablen addiert. Operand1 und Operand2 sind numerische Ausdrücke.

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

Das folgende Beispiel verwendet die Script-Funktion ADD, um eine Bedingung zu definieren:

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

Das folgende Beispiel addiert zwei Fließkommazahlen und gibt das Ergebnis im Aktivierungsreport aus:

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

Das Ergebnis im Aktivierungsreport sieht wie folgt aus:

U0020408 +0000000000000004.8600000000000000

Das folgende Beispiel zeigt eine weitere Möglichkeit, Zahlen zu addieren, indem der Wert einer Variablen mit einem arithmetischen Ausdruck gesetzt wird:

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

Das Ergebnis im Aktivierungsreport sieht wie folgt aus:

U0020408 0000000000000002

Siehe auch: