Divisionsrestoperator (Mod) (FPScript)
Ermittelt den Rest einer Division.
Syntax
Dividend Mod Divisor
Die Syntax des Mod Operators besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
Dividend |
Ein beliebiger Ausdruck. Es sind alle reellen Datentypen und Zeichenketten erlaubt. |
Divisor |
Wie Dividend. Darf jedoch nicht 0 sein. |
Anmerkungen
Der Rest der Division ist der Wert, der vom Dividend subtrahiert werden müsste, damit die Division ganzzahlig wird. Der Divisor muss keine ganze Zahl sein.
Der Operator kann Einzelwerte oder auch ganze Datenreihen und Datenmatrizen verarbeiten. Ist mindestens ein Argument eine Datenreihe oder eine Datenmatrix, erfolgt die Division elementweise und das Ergebnis ist wieder eine Datenreihe bzw. eine Datenmatrix. Ist mindestens eines der beiden Argumente eine Datenmatrix, dann müssen beide Argumente die gleiche Zeilenanzahl aufweisen. Bei unterschiedlicher Spaltenanzahl von Datenmatrizen bzw. bei unterschiedlicher Zeilenanzahl von Datenreihen werden überschüssige Spalten bzw. Werte entfernt.
Wenn Signale, Signalreihen oder Raumkurven dividiert werden, werden nur deren Y-Komponenten betrachtet. Das Ergebnis erhält dann bevorzugt die X- und ggf. Z-Komponente von Dividend, ansonsten die von Divisor. Liefert einer der Ausdrücke eine Liste, dann wird die Operation für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.
Der Operator kann auf alle reellen Datentypen sowie auf Zeitspannen und Zeichenketten angewandt werden. Das Ergebnis ist immer vom gleichen Datentyp wie die Ausdrücke. Wenn die Ausdrücke verschiedene Datentypen haben, werden diese so angepasst, dass kein Auflösungsverlust beim Ergebnis erfolgt, d. h. niedrigere Auflösungen werden zu höheren gewandelt und Ganzzahlen zu Fließkommazahlen.
Sie können Zeitspannenwerte durch numerische Werte oder Zeitspannenwerte dividieren. Beide Operanden werden dann als Sekunden interpretiert und das Ergebnis ist ein dem Divisionsrest entsprechender Zeitspannenwert.
Ist ein Argument numerisch und das andere eine Zeichenkette, so wird die Zeichenkette vor der Operation in den numerischen Typ gewandelt. Es dürfen nicht beide Argumente Zeichenketten sein.
Eine Division durch 0 ergibt bei Fließkomma-Datentypen einen ungültigen Wert als Ergebnis. Bei ganzzahligen Datentypen wird ein Fehler ausgegeben.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
5. Mod 1.5 |
Liefert die 64-Bit Fließkommazahl 0.5, denn 5 = 3 * 1.5 + 0.5, d. h. 1.5 passt dreimal in 5 mit Rest 0.5. |
"5,5" Mod 2n |
Liefert die 32-Bit Ganzzahl 1, da die Zeichenkette in den Typ des numerischen Ergebnisses gewandelt wird. Beachten Sie, dass das in Windows eingestellte länderspezifische Dezimaltrennzeichen in der Zeichenkette verwendet werden muss. |
'12:34:56.78' Mod 60 |
Liefert den Zeitspannenwert '00:00:36.78', d. h. den Sekundenanteil. |
'12:34:56.78' Mod 3600 - '12:34:56.78' Mod 60 |
Liefert den Zeitspannenwert '00:34:00', d. h. den Minutenanteil. |
{ 3., 2.} Mod {2., 0.} |
Liefert die Datenreihe mit 64-Bit Fließkommazahlen { 1., ? }. |