set_dict_tupleT_set_dict_tupleSetDictTupleSetDictTuple (Operator)

Name

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

Signatur

set_dict_tuple( : : DictHandle, Key, Tuple : )

Beschreibung

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

TupleTupleTupleTupletuple 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 TupleTupleTupleTupletuple ersetzt.

KeyKeyKeyKeykey 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_tupleGetDictTupleGetDictTupleGetDictTuple aus dem Dictionary wieder ausgelesen werden.

Achtung

Falls TupleTupleTupleTupletuple 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:

DictHandleDictHandleDictHandleDictHandledictHandle

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

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

Handle des Dictionaries.

Parameteranzahl: DictHandle == 1

KeyKeyKeyKeykey (input_control) string → (string / integer)

Schlüssel.

Parameteranzahl: Key == 1

Restriktion: length(Key) > 0

TupleTupleTupleTupletuple (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_tupleSetDictTupleSetDictTupleSetDictTuple 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) oder ein Allokierungsfehler.

Vorgänger

create_dictcreate_dictCreateDictCreateDictCreateDict

Nachfolger

set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObject

Alternativen

set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObject

Siehe auch

create_dictcreate_dictCreateDictCreateDictCreateDict, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObject, get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObject, get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParam, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKey

Modul

Foundation

Operatoren