CX_OBJECT_DICTIONARY::RegExQuery
Beschreibung:
Diese Funktion gibt eine Liste (Collection) der Objekte zurück, die unter dem als
Parameter übergebenen Suchbegriff im Dictionary gefunden werden.
Das Suchargument wird als regular Expression aufgefasst. Ein im
Dictionary eingetragenes Objekt gehört genau dann zur Ergebnismenge, wenn sein
Eintrag mit dem regulären Ausdruck des Sucharguments übereinstimmt.
Dabei wird die Groß-/Kleinschreibung wie angegeben beachtet.
Mit dem INTEGER-Parameter (Begrenzung) wird die Anzahl der zurückgegebenen Objekte
Code-Beispiel:
Var(dict, matchingObjects)
"uniqueID = \"D3\"" FindFirst(CX_OBJECT_DICTIONARY) -> dict // get dictionary
// .....................................................
Prompt(RED, FONT(0), 235, 22, "Regular Expression:")
String(regex, 306, 22, 300)
[
SELECT: GetValue 100 /* max. 100 results */ dict Call(RegExQuery) -> matchingObjects
]
Anmerkung:
Zum Finden von SubStrings muss bei den Objekt-Dictionaries .* für den nicht im Substring enthaltenen String angegeben werden. Um z. B. den Dictionary-String "Jane Doe" bei der Suche nach "Doe" zu finden, muss man ".*Doe$" angeben.
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_OBJECT_DICTIONARY | Dictionary Objekt |
Top-1 | INTEGER | Begrenzung | |
Top-2 | STRING | Suchargument als regular Expression | |
Stack(Out) | Top | COLLECTION | gefundene Objekte |