CX_OBJECT_DICTIONARY_CI::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. Die Suche erfolgt case-insensitiv.
Achtung: Im Gegensatz zu Enter, entfernt Query keine Leerzeichen am Anfang und am Ende des Suchbegriffs. Das kann dazu führen, dass ein Begriff, der mit Enter eingetragen wurde, anschließend nicht mit Query gefunden werden kann.
Code-Beispiel:
Var(dict, matchingObjects) "uniqueID = \"D4\"" FindFirst(CX_OBJECT_DICTIONARY_CI) -> dict // get dictionary // ..................................................... Prompt(RED, FONT(0), 235, 22, "Key:") String(key, 306, 22, 300) [ SELECT: GetValue 100 /* max. 100 results */ dict Call(Query) -> matchingObjects ]
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_OBJECT_DICTIONARY_CI | Dictionary Objekt |
Top-1 | INTEGER | Begrenzung | |
Top-2 | STRING | Suchbegriff | |
Stack(Out) | Top | COLLECTION | gefundene Objekte |