get_dict_objectT_get_dict_objectGetDictObjectGetDictObjectget_dict_object (Operator)

Name

get_dict_objectT_get_dict_objectGetDictObjectGetDictObjectget_dict_object — Zurückgeben der in einem Dictionary von einem Schlüssel referenzierten ikonischen Objekte.

Signatur

get_dict_object( : Object : DictHandle, Key : )

Beschreibung

get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object fragt aus dem Dictionary DictHandleDictHandleDictHandleDictHandledictHandledict_handle das mit dem Schlüssel KeyKeyKeyKeykeykey assoziierte ikonische Objekt ObjectObjectObjectObjectobjectValobject ab. Das ikonische Objekt muss zuvor mit Hilfe des Operators set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object in dem Dictionary abgespeichert worden sein.

Falls der spezifizierte Schlüssel KeyKeyKeyKeykeykey nicht in dem Dictionary hinterlegt ist oder die mit ihm verbundenen Daten kein ikonisches Objekt sondern ein Datentupel ist, schlägt get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object fehl. Die gespeicherten Schlüssel und die Information über die von ihnen referenzierten Daten kann über den Operator get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param abgefragt werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

ObjectObjectObjectObjectobjectValobject (output_object) object(-array) → object

Vom Schlüssel referenziertes Objekt.

DictHandleDictHandleDictHandleDictHandledictHandledict_handle (input_control) dict → (handle)

Handle des Dictionaries.

Parameteranzahl: DictHandle == 1

KeyKeyKeyKeykeykey (input_control) string → (string / integer)

Schlüssel.

Parameteranzahl: Key == 1

Restriktion: length(Key) > 0

Beispiel (HDevelop)

* ...
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')

Ergebnis

Im Erfolgsfall gibt get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_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.

Vorgänger

set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object

Nachfolger

get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object

Alternativen

get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple

Siehe auch

create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKeyremove_dict_key, get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param

Modul

Foundation

Operatoren