CX_OBJECT_DICTIONARY_CI::RegExQuery

CX_OBJECT_DICTIONARY_CI::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 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

Code-Beispiel:

Var(dict, matchingObjects)
"uniqueID = \"D4\"" FindFirst(CX_OBJECT_DICTIONARY_CI) -> 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.

Funktionsaufruf: Call(RegExQuery)