CX_OBJECT_DICTIONARY::Query
Beschreibung:
Diese Funktion gibt eine Liste (Collection) der Objekte zurück, die unter dem als Parameter übergebenen Suchbegriff im Dictionary eingetragen sind (Matchcode). Mit dem INTEGER-Parameter (Begrenzung) wird die Anzahl der zurückgegebenen Objekte gesteuert: bei 0 werden alle Objekte zurückgegeben.
Der Suchbegriff darf Wildcards enthalten.
Achtung: Im Gegensatz zu Enter werden Leerzeichen am Anfang und am Ende des Suchbegriffs nicht abgeschnitten. Dies kann dazu führen, dass ein Schlüssel, der per Enter eingefügt wurde, anschließend nicht gefunden wird.
Code-Beispiel:
Var(dict, matchingObjects) "CX_PARTNER" cxDictionary::GetObjectDictionary -> dict "Müller" 100 /* max. 100 results */ dict Call(Query) -> matchingObjects
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_OBJECT_DICTIONARY | Dictionary Objekt |
Top-1 | INTEGER | Begrenzung | |
Top-2 | STRING | Suchbegriff | |
Stack(Out) | Top | COLLECTION | gefundene Objekte |