StringLeft (FPScript)
Entnimmt eine Teilzeichenkette von links aus einer Zeichenkette.
Syntax
StringLeft(String, Length)
Die Syntax der StringLeft-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
String |
Die Zeichenkette, aus der eine Teilzeichenkette entnommen werden soll. Erlaubte Datenstrukturen sind Einzelwert, Datenreihe und Datenmatrix. Unterstützte Datentypen sind Zeichenkette. |
Length |
Die Länge der Teilzeichenkette. Erlaubte Datenstrukturen sind Einzelwert, Datenreihe und Datenmatrix. Es sind alle ganzzahligen Datentypen erlaubt. |
Anmerkungen
Der Datentyp des Ergebnisses ist immer Zeichenkette.
Die Struktur des Ergebnisses entspricht der des Arguments String.
Wenn die angegebene Länge die Länge der Zeichenkette überschreitet, wird die vollständige Zeichenkette übergeben. Wenn die Länge kleiner oder gleich Null ist, wird eine leere Zeichenkette übergeben.
Wenn das Argument String eine Datenreihe oder eine Datenmatrix ist, so erfolgt die Berechnung elementweise und das Ergebnis ist wieder eine Datenreihe bzw. eine Datenmatrix. Ist das Argument Length eine Datenreihe oder Datenmatrix, dann muss Length in Zeilenanzahl und ggf. Spaltenanzahl mit dem Argument String übereinstimmen.
Ist ein Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
StringLeft("Dies ist ein Beispiel", 4) |
Übergibt die Teilzeichenkette "Dies". |
StringLeft({"2014-04-22", "2015-04-19", "2016-04-28"} , 4) |
Ergibt die Datenreihe {"2014", "2015", "2016"}. |
Dim names = {"M75_Val", "M633_Val", "M11850_Val"} |
Ergibt die Datenreihe {"M75", "M633", "M11850"}. |