CX_DICTIONARY::RegExQuery
Achtung: Diese Methode wird ab Dll-Version 222083 nicht mehr unterstützt. Bitte stattdessen die neuen Dictionary-Klassen verwenden.
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 einer seiner Einträge (in der aktuellen Sprache) mit dem regulären Ausdruck des Sucharguments übereinstimmt.
Mit dem INTEGER-Parameter (Begrenzung) wird die Anzahl der zurückgegebenen Objekte gesteuert: bei 0 werden alle Objekte zurückgegeben.
Code-Beispiel:
Var(dict, matchingObjects) "name = \"D1\"" FindFirst(CX_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 ]
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_DICTIONARY | Dictionary Objekt |
Top-1 | INTEGER | Begrenzung | |
Top-2 | STRING | Suchargument als regular Expression | |
Stack(Out) | Top | COLLECTION | gefundene Objekte |