get_dict_tupleT_get_dict_tupleGetDictTupleGetDictTupleget_dict_tuple (Operator)

Name

get_dict_tupleT_get_dict_tupleGetDictTupleGetDictTupleget_dict_tuple — Zurückgeben der in einem Dictionary über einen Schüssel referenzierten Tupeldaten.

Signatur

get_dict_tuple( : : DictHandle, Key : Tuple)

Beschreibung

get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple fragt aus dem Dictionary DictHandleDictHandleDictHandledictHandledict_handle die mit einem Schlüssel KeyKeyKeykeykey assoziierten Tupeldaten TupleTupleTupletupletuple ab. Die Tupeldaten müssen zuvor mit Hilfe des Operators set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple in dem Dictionary abgespeichert worden sein.

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

Der Abruf mehrerer Schlüssel ist nur möglich, wenn für jeden dieser Schlüssel ein Tupel mit genau einem Element hinterlegt ist.

HDevelop Inline-Operation

HDevelop unterstützt eine Inline-Operation für get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Dynamische Syntax:

Tuple := DictHandle.['Key']
Statische Syntax:

Tuple := DictHandle.Key

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

DictHandleDictHandleDictHandledictHandledict_handle (input_control) dict → (handle)

Handle des Dictionaries.

Parameteranzahl: DictHandle == 1

KeyKeyKeykeykey (input_control) string(-array) → (string / integer)

Schlüssel.

TupleTupleTupletupletuple (output_control) tuple(-array) → (string / integer / real)

Vom Schlüssel referenzierte Tupeldaten.

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_tuple (Dict, 'simple_string', TupleString)
*
* Access multiple keys, if their tuple all have length 1
get_dict_tuple (Dict, ['key1','key2','key3'], MultipleValues)

Ergebnis

Im Erfolgsfall gibt get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_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), Abwesenheit des Schlüssels in dem Dictionary oder wenn der Schüssel andere Datentypen als ein Datentupel referenziert.

Vorgänger

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple

Nachfolger

get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_tuple_atset_dict_tuple_atSetDictTupleAtSetDictTupleAtset_dict_tuple_at

Alternativen

get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object

Siehe auch

create_dictcreate_dictCreateDictCreateDictcreate_dict, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object, get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyremove_dict_key, get_dict_paramget_dict_paramGetDictParamGetDictParamget_dict_param

Modul

Foundation

Operatoren