Sucht nach einem oder mehreren Listenelementen in einer benannten Liste.
Syntax
SearchListElements(List, ElementName, [ IgnoreCase = TRUE ] [ , ElementNameType = ELEMENTNAMETYPE_NAME ])
Die Syntax der SearchListElements-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
List |
Eine Liste, in der nach Elementen gesucht werden soll. Erlaubte Datenstrukturen sind Liste. Es sind alle Datentypen erlaubt. |
||||||||||
ElementName |
Ein Einzelwert oder eine Datenreihe mit den Namen, nach denen gesucht werden soll. Es können auch "Wildcard"-Zeichen '?' oder '*' angegeben werden. Dann wird ein Mustervergleich durchgeführt. Das *-Zeichen steht hierbei für eine beliebige Zeichenfolge inklusive der leeren Zeichenfolge und das ?-Zeichen für ein einzelnes beliebiges Zeichen. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. 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. |
||||||||||
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 TRUE gesetzt. |
||||||||||
ElementNameType |
Bestimmt, wie die Elementnamen der Ergebnisliste erzeugt werden. Das Argument ElementNameType 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 ELEMENTNAMETYPE_NAME gesetzt. |
Anmerkungen
Falls ein Listenelement keinen Namen hat, so wird es ignoriert. Es wird nur nach Listenelementen gesucht, die selbst keine Elemente enthalten, also nach den Blättern einer Liste bei Betrachtung als Baum. Es werden alle Listenelemente, auf deren Elementnamen das Suchkriterium passt, in unveränderter Reihenfolge in die Ergebnisliste übernommen.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
SearchListElements([<a>1, <b>2], "a") |
Ergibt [<a>1]. Das Ergebnis ist eine Liste mit einem Element 'a'. |