Subtraktionsoperator (-) (FPScript)
Subtrahiert zwei Ausdrücke voneinander.
Syntax
Ausdruck1 - Ausdruck2
Die Syntax des - Operators besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
Ausdruck1 |
Ein beliebiger Ausdruck. Es sind alle Datentypen außer Wahrheitswerten erlaubt. |
Ausdruck2 |
Wie Ausdruck1. |
Anmerkungen
Der Operator kann Einzelwerte oder auch ganze Datenreihen und Datenmatrizen verarbeiten. Ist mindestens ein Argument eine Datenreihe oder eine Datenmatrix, erfolgt die Subtraktion 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 subtrahiert werden, werden nur deren Y-Komponenten betrachtet. Das Ergebnis erhält dann bevorzugt die X- und ggf. Z-Komponente von Ausdruck1 ansonsten die von Ausdruck2. 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 und komplexen Datentypen sowie auf Kalenderzeiten, Zeitspannen und Zeichenketten angewandt werden. Bei komplexen Argumenten erfolgt eine komplexe Subtraktion und das Ergebnis ist ebenfalls komplex. 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, Ganzzahlen zu Fließkommazahlen und reelle Zahlen zu komplexen Zahlen.
Die komplexe Subtraktion ist definiert als (a, b) - (c, d) = (a - c, b - d).
Wenn Sie Zeitspannenwerte von Kalenderzeitwerten subtrahieren, ist das Ergebnis ein Kalenderzeitwert. Wenn Sie Zeitspannenwerte von Zeitspannenwerten subtrahieren, ist das Ergebnis ein Zeitspannenwert. Das gleiche gilt, wenn Sie Kalenderzeitwerte subtrahieren. Sie können auch einen numerischen Wert von einem Kalenderzeitwert oder einem Zeitspannenwert subtrahieren, dieser wird dann als Sekunden interpretiert. Das Gleiche gilt, wenn sie einen Zeitspannenwert von einem numerischen Wert subtrahieren. Bei komplexen Werten wird vor der Subtraktion der Betrag gebildet. Kalenderzeiten können jedoch nicht von einem numerischen Wert subtrahiert werden.
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.
Ist Ausdruck1 und Ausdruck2 eine Größe, dann müssen diese die gleiche SI-Dimension haben und die Einheit von Ausdruck2 wird vor der Subtraktion auf die Einheit von Ausdruck1 transformiert. Ist nur ein Operand eine Größe, dann wird für den anderen Operanden die gleiche Einheit angenommen. Bei aktivierter Prozentrechnung wird, wenn der rechte Operand in der Einheit % oder ppm (parts per million) vorliegt, ein Abschlag berechnet:
Ausdruck1 - Ausdruck2[%] = Ausdruck1 - Ausdruck1 * (Ausdruck2 / 100 %)
Bei der Einheit ppm wird entsprechend mit 1.000.000 ppm statt mit 100 % gerechnet.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
Signal - Mean(Signal) |
Entfernt den Gleichanteil eines Signals. |
Signal(Signal.y, Signal.x - 10.) |
Verschiebt ein Signal in X-Richtung nach links. |
(1., 2.) - 1. |
Liefert die komplexe 64-Bit Fließkommazahl (0., 2.). |
"1,23" - 1n |
Liefert die 32-Bit Ganzzahl 0, 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. |
'1.1.2000 12:00:00' - '1:30:00' |
Liefert den Kalenderzeitwert '1.1.2000 10:30:00'. |
'1.1.2000' - '1.1.2000 12:00:00' |
Liefert den Zeitspannenwert '-12:00:00'. |
'12:00:00' - 120.5 |
Liefert den Zeitspannenwert '11:57:59.5'. |
3 m - 50 mm |
Liefert 2.95 m. |
3 - 50 mm |
Liefert -47 mm. |
3 m - 50 |
Liefert -47 m. |
200 m - 10 % |
Liefert 200 m - 200 m * (10/100) = 180 m. |