set_dict_object — Hinzufügen eines Schlüssel-Objekt-Paares zu einem Dictionary.
set_dict_object(Object : : DictHandle, Key : )
set_dict_object speichert in einem Dictionary ähnlich zu
einem assoziativem Array ein ikonisches Objekt in Verbindung mit
einem Schlüssel ab. Das Dictionary wird im Parameter
DictHandle übergeben.
Object wird durch die Operation kopiert (vgl. copy_obj)
und kann daher anschließend ohne Seiteneffekte weiterverwendet oder gelöscht
werden. Sowohl leere Objekte als auch ikonische Tupelobjekte sind
zulässig und können von einem Schlüssel referenziert
werden. Falls bereits Daten (Tupel oder Objekt) durch den angegebenen
Schlüssel referenziert werden, werden die alten Daten freigegeben
und durch Object ersetzt.
Key ist ein String oder eine ganze Zahl (integer).
Bei Strings muss die Groß-/Kleinschreibung beachtet.
Die ikonischen Objekte für den
übergebenen Schlüssel können mit Hilfe des Operators
get_dict_object aus dem Dictionary wieder ausgelesen
werden.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Object (input_object) object(-array) → object
Vom Schlüssel zu referenzierendes ikonisches Objekt.
DictHandle (input_control, Zustand wird modifiziert) dict → (handle)
Handle des Dictionaries.
Parameteranzahl: DictHandle == 1
Key (input_control) string → (string / integer)
Schlüssel.
Parameteranzahl: Key == 1
Restriktion: length(Key) > 0
create_dict (Dict) read_image (Image, 'filename') set_dict_object (Image, Dict, 'my_image')
Im Erfolgsfall gibt set_dict_tuple den Wert 2 (H_MSG_TRUE) zurück.
Andernfalls wird eine Fehlerbehandlung durchgeführt. Mögliche Fehler
sind ungültige Parameter (Dictionary oder Schlüssel) oder ein
Allokierungsfehler.
create_dict,
set_dict_tuple,
get_dict_tuple,
get_dict_object,
remove_dict_key,
get_dict_param
Foundation