set_dict_objectT_set_dict_objectSetDictObjectSetDictObjectset_dict_object (Operator)

Name

set_dict_objectT_set_dict_objectSetDictObjectSetDictObjectset_dict_object — Hinzufügen eines Schlüssel-Objekt-Paares zu einem Dictionary.

Signatur

set_dict_object(Object : : DictHandle, Key : )

Beschreibung

set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object speichert in einem Dictionary ähnlich zu einem assoziativem Array ein ikonisches Objekt in Verbindung mit einem Schlüssel ab. Das Dictionary wird im Parameter DictHandleDictHandleDictHandleDictHandledictHandledict_handle übergeben.

ObjectObjectObjectObjectobjectValobject wird durch die Operation kopiert und kann daher anschließend ohne Seiteneffekte weiterverwendet werden. Dabei werden die Objektdaten in die HALCON-Datenbank kopiert, d.h., das neue Objekt enthält Verweise auf ObjectObjectObjectObjectobjectValobject, vgl. copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj.

Sowohl leere Objekte als auch ikonische Tupelobjekte sind zulässig und können von einem Schlüssel referenziert werden. Falls bereits Daten (Tupel oder Objekt) durch den angegebenen Schlüssel referenziert werden, werden die alten Daten freigegeben und durch ObjectObjectObjectObjectobjectValobject ersetzt.

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

Die ikonischen Objekte für den übergebenen Schlüssel können mit Hilfe des Operators get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object aus dem Dictionary wieder ausgelesen 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.

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

ObjectObjectObjectObjectobjectValobject (input_object) object(-array) → object

Vom Schlüssel zu referenzierendes ikonisches Objekt.

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

Beispiel (HDevelop)

create_dict (Dict)
read_image (Image, 'filename')
set_dict_object (Image, Dict, 'my_image')

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_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple

Alternativen

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple

Siehe auch

create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple, get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKeyremove_dict_key, get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param

Modul

Foundation

Operatoren