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