SearchStrings (FPScript)
Sucht in einer Datenreihe nach einer Zeichenkette und übergibt die Indizes der Treffer als Datenreihe.
Syntax
SearchStrings(StringSeries, String, [ Operation = SEARCH_OP_IS ] [ , IgnoreCase = FALSE ])
Die Syntax der SearchStrings-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
StringSeries |
Die Datenreihe mit Zeichenketten, in der nach der Zeichenkette gesucht werden soll. Erlaubte Datenstrukturen sind Datenreihe. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||||||||||
String |
Die Zeichenkette, nach der gesucht werden soll. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||||||||||||||||
Operation |
Bestimmt, wie die Zeichenketten verglichen werden. Das Argument Operation kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert SEARCH_OP_IS gesetzt. |
||||||||||||||||||||||||||
IgnoreCase |
Ein Wahrheitswert der angibt, ob beim Suchen die Groß-Kleinschreibung ignoriert werden soll. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
Anmerkungen
Als Ergebnis liefert die Funktion eine Datenreihe vom Datentyp 64-Bit Ganzzahl.
Das Ergebnis ist eine Datenreihe mit den Indizes der gefundenen Zeichenketten.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
Dim names = {"Channel1", "Channel2", "Channel2", "Channel1", "Channel1", "Channel2"}
Dim data = { 1, -1, -2, 2, 3, -3 }
return data[SearchStrings(names, "Channel2")]
Gibt alle Datenwerte aus einem Protokoll zurück, die zu "Channel2" gehören.