Automation Engine Script-Leitfaden > Funktionelle Gliederung > Rechnen > MULT

MULT

Script-Funktion: Führt eine Multiplikation aus.

Syntax

MULT(Operand1, Operand2)

Syntax

Beschreibung/Format

Operand1

Erster Rechenausdruck.
Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata

Operand2

Zweiter Rechenausdruck.
Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata.


Rückgabewert

Ergebnis der Multiplikation

Kommentare

Die Script-Funktion multipliziert Operand1 mit Operand2.

Operand1 undOperand2mü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 bei der Definition mit dem Sprachmittel :DEFINE festgelegt. 

Es zählt immer der Datentyp des Ergebnis, nicht jener der Operanden! Beispiel: Zwei negative Operanden ergeben eine positive Zahl, 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. Das Beispiel liefert als Ergebnis "100".

:SET  &OP1# = 4
:
SET  &OP2# = 25
:
SET  &RESULT# = MULT(&OP1#,&OP2#)

Folgendes Beispiel zeigt eine Multiplikation mit Gleitkommazahlen.

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

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 -0000000000000056.1895000000000000

Eine weitere Möglichkeit für eine Multiplikation

Eine weitere Möglichkeit für eine Multiplikation wird im Folgenden gezeigt. In diesem Beispiel ist der Wert einer Script-Variable auf das Ergebnis aus 7 mal 8 festgelegt.

:SET &MULTIPLY# = 7 * 8
:
P &MULTIPLY#

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 0000000000000056

 

Siehe auch:

Script-Sprachmittel Beschreibung

ADD

Führt eine Addition aus.
SUB Führt eine Subtraktion aus.
MOD Gibt den Restwert einer Division zurück.
DIV Führt eine Division aus.
RANDOM Generiert Zufallszahlen.

Script-Sprachmittel - Rechnen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung

Script-Sprachmittel -Funktionelle Gliederung

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH