CX_OBJECT_DICTIONARY::Enter
Beschreibung:
Diese Funktion fügt einen neuen Eintrag für das Objekt im Dictionary ein, so dass dieses Objekt unter den Begriff (Bezeichnername) wiedergefunden werden kann.
Die Funktion entfernt Whitespace am Anfang und Ende des Bezeichners.
Ein leerer Bezeichner (keine signifikanten Zeichen!) wird mit einer Fehlermeldung abgewiesen.
Es kommt auch zu einer Fehlermeldung, wenn das Objekt bereits unter dem gleichen Begriff registriert wurde.
Code-Beispiel:
Var(dict) CreateTransObject(CX_OBJECT_DICTIONARY) -> dict "cx" user dict Call(Enter) "cx" user dict Call(Exists) // -> TRUE "c*" 0 dict Call(Query) // -> Collection (user) "cx" user dict Call(Remove) "c*" 0 dict Call(Query) // -> empty Collection
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_OBJECT_DICTIONARY | Dictionary |
Top-1 | OBJECT | zu registrierendes Objekt | |
Top-2 | STRING | Bezeichnername (Begriff) |
Funktionsaufruf: Call(Enter)
Hinweis: Neue Einträge können auch mittels der Funktionen LanguageKey() (siehe Klasse CX_OBJECT_KEYWORD) erzeugt werden.