get_dict_object — Zurückgeben der in einem Dictionary von einem Schlüssel
referenzierten ikonischen Objekte.
get_dict_object( : Object : DictHandle, Key : )
get_dict_object fragt aus dem Dictionary
DictHandle das mit dem Schlüssel Key
assoziierte ikonische Objekt Object ab. Das ikonische
Objekt muss zuvor mit Hilfe des Operators set_dict_object
in dem Dictionary abgespeichert worden sein.
Falls der spezifizierte Schlüssel Key nicht in dem
Dictionary hinterlegt ist oder die mit ihm verbundenen Daten
kein ikonisches Objekt sondern ein Datentupel ist, schlägt
get_dict_object fehl. Die gespeicherten Schlüssel und
die Information über die von ihnen referenzierten Daten kann über
den Operator get_dict_param abgefragt werden.
Object (output_object) object(-array) → object
Vom Schlüssel referenziertes Objekt.
DictHandle (input_control) dict → (handle)
Handle des Dictionaries.
Parameteranzahl: DictHandle == 1
Key (input_control) string → (string / integer)
Schlüssel.
Parameteranzahl: Key == 1
Restriktion: length(Key) > 0
* ...
get_dict_param (Dict, 'key_exists', ['simple_string','foo','my_image'], \
KeysPresence)
get_dict_param (Dict, 'key_data_type', ['simple_string','my_image'], \
KeysType)
get_dict_object (Image, Dict, 'my_image')
Im Erfolgsfall gibt get_dict_object 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), Abwesenheit des Schlüssels in
dem Dictionary oder wenn der Schüssel andere Datentypen als ein
ikonisches Objekt referenziert.
create_dict,
set_dict_tuple,
get_dict_tuple,
set_dict_object,
remove_dict_key,
get_dict_param
Foundation