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

DIV

Script-Funktion: Führt eine Division aus.

Syntax

DIV(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 Division

Kommentare

Die Script-Funktion dividiert Operand1 durch Operand 2.

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

DerOperand2 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 auf die nächste Ganzzahl auf- oder abgerundet. 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 "5" der Rechenoperation an eine Script-Variable übergeben. Als Operand1 und Operand2 werden Script-Variablen verwendet.

:SET &OP1# = '100'
:
SET &OP2# = '20'
:
SET &RESULT# = DIV(&OP1#,&OP2#)

Wenn der Datentyp der Zielvariable nicht "float" (oder "string") entspricht, so werden Nachkommastellen auf die nächste Ganzzahl auf- oder abgerundet. Im folgenden Beispiel wird daher der Wert "0" in die Variable gespeichert. 

:DEFINE &RESULT#, unsigned
:
SET &RESULT# = DIV(10,30)

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

:DEFINE &RESULT#,float
:SET &RESULT#DIV(-9,-2.25)
:P &RESULT#

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 +0000000000000004.0000000000000000

Eine weitere Möglichkeit für die Division

Eine weitere Möglichkeit für die Division wird unten dargestellt. In diesem Beispiel ist der Wert einer Script-Variable auf das Ergebnis aus 10 dividiert durch 2 festgelegt.

:SET &DIVIDE# = 10 * 2
:
P &DIVIDE#

Das Ergebnis wird wie folgt im Aktivierungsprotokoll ausgegeben:

U0020408 0000000000000005

 

Siehe auch:

Script-Sprachmittel Beschreibung

ADD

Führt eine Addition aus.
SUB Führt eine Subtraktion aus.
MULT Führt eine Multiplikation aus.
MOD Liefert den Restwert einer Division.
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