CX_DICTIONARY_CI::RegExQuery

CX_DICTIONARY_CI::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.
Dabei wird immer case-insensitive gearbeitet, auch wenn das im regulären Ausdruck nicht explizit angegeben wurde.
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 = \"D2\"" 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
]

Funktionsaufruf: Call(RegExQuery)