set_dict_tupleT_set_dict_tupleSetDictTupleSetDictTupleset_dict_tuple (Operator)

Name

set_dict_tupleT_set_dict_tupleSetDictTupleSetDictTupleset_dict_tuple — Hinzufügen eines Schlüssel-Tupeldaten-Paares zu einem Dictionary.

Signatur

set_dict_tuple( : : DictHandle, Key, Tuple : )

Beschreibung

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple speichert in dem Dictionary DictHandleDictHandleDictHandleDictHandledictHandledict_handle ähnlich zu einem assoziativem Array ein Datentupel in Verbindung mit einem Schlüssel ab.

TupleTupleTupleTupletupletuple wird in das Dictionary kopiert und kann anschließend weiterverwendet oder gelöscht werden. Ein leeres Tupel ist ebenfalls ein gültiger Wert, der mit einem Schlüssel referenziert werden kann. Falls bereits Daten (Tupel oder Objekt) durch den gegebenen Schlüssel referenziert werden, werden die alten Daten freigegeben und durch TupleTupleTupleTupletupletuple ersetzt.

KeyKeyKeyKeykeykey ist ein String oder eine ganze Zahl (integer). Bei Strings muss die Groß-/Kleinschreibung beachtet.

Die Tupeldaten für den übergebenen Schlüssel können mit Hilfe des Operators get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple aus dem Dictionary wieder ausgelesen werden.

Achtung

Falls TupleTupleTupleTupletupletuple Handles enthält, werden nur die Handle-Werte kopiert. Von Handles, die in dem Tupel enthalten sind, wird keine tiefe Kopie erzeugt.

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.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

DictHandleDictHandleDictHandleDictHandledictHandledict_handle

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.

Parameter

DictHandleDictHandleDictHandleDictHandledictHandledict_handle (input_control, Zustand wird modifiziert) dict → (handle)

Handle des Dictionaries.

Parameteranzahl: DictHandle == 1

KeyKeyKeyKeykeykey (input_control) string → (string / integer)

Schlüssel.

Parameteranzahl: Key == 1

Restriktion: length(Key) > 0

TupleTupleTupleTupletupletuple (input_control) tuple-array → (string / integer / real)

Vom Schlüssel zu referenzierende Tupeldaten.

Beispiel (HDevelop)

create_dict (Dict)
set_dict_tuple (Dict, 'simple_integer', 27)
set_dict_tuple (Dict, 'simple_string', 'Hello world')
set_dict_tuple (Dict, 'mixed_tuple', ['The answer', 42])
set_dict_tuple (Dict, 0, 'This is zero')

Ergebnis

Im Erfolgsfall gibt set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple den Wert TRUE zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt. Mögliche Fehler sind ungültige Parameter (Dictionary oder Schlüssel) oder ein Allokierungsfehler.

Vorgänger

create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict

Nachfolger

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object

Alternativen

set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object

Siehe auch

create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object, get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object, get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKeyremove_dict_key

Modul

Foundation

Operatoren