copy_dictT_copy_dictCopyDictCopyDictcopy_dict (Operator)

Name

copy_dictT_copy_dictCopyDictCopyDictcopy_dict — Kopieren eines Dictionaries.

Signatur

copy_dict( : : DictHandle, GenParamName, GenParamValue : CopiedDictHandle)

Beschreibung

copy_dictcopy_dictCopyDictCopyDictcopy_dict erstellt eine tiefe Kopie (d.h. von allen im Dictionary enthaltenen Handles und ikonischen Objekten wird eine tiefe Kopie erstellt) des Dictionary DictHandleDictHandleDictHandledictHandledict_handle und gibt diese als Dictionary in CopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle zurück.

Wenn DictHandleDictHandleDictHandledictHandledict_handle ein Handle enthält, das nicht kopiert werden kann oder das schon freigegeben wurde, bricht copy_dictcopy_dictCopyDictCopyDictcopy_dict standardmäßig mit einer Fehlermeldung ab. Dieses Verhalten kann durch Setzen von GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name auf 'raise_error_if_content_not_serializable' verändert werden, der zugehörige GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value kann folgende Werte annehmen:

'true'"true""true""true""true":: Der Default: Fehler werden geworfen und der Kopierprozess abgebrochen.
'low_level'"low_level""low_level""low_level""low_level":: Nur Low-Level-Fehler werden geworfen. Anstatt des betreffenden Handles wird ein leeres Handle in CopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle kopiert und der Kopierprozess weitergeführt. Der Umgang mit HALCON Low-Level-Fehlern wird durch 'do_low_error'"do_low_error""do_low_error""do_low_error""do_low_error" in set_systemset_systemSetSystemSetSystemset_system bestimmt.
'false'"false""false""false""false":: Es werden keine Fehler geworfen. Anstatt des betreffenden Handles wird ein leeres Handle in CopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle kopiert und der Kopierprozess weitergeführt.

Ausführungsinformationen

Multithreading-Typ: independent (läuft parallel auch zu 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

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → (string)

Name des generischen Parameters.

Default: []

Werteliste: 'raise_error_if_content_not_serializable'

GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.name(-array) → (string / integer / real)

Wert des generischen Parameters.

Default: []

Wertevorschläge: 'true'"true""true""true""true", 'false'"false""false""false""false", 'low_level'"low_level""low_level""low_level""low_level"

CopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle (output_control) dict → (handle)

Kopiertes Handle des Dictionaries.

Parameteranzahl: CopiedDictHandle == 1

Ergebnis

Sind die Parameterwerte korrekt, dann liefert copy_dictcopy_dictCopyDictCopyDictcopy_dict den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_dictread_dictReadDictReadDictread_dict, deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle, create_dictcreate_dictCreateDictCreateDictcreate_dict

Nachfolger

write_dictwrite_dictWriteDictWriteDictwrite_dict

Siehe auch

read_dictread_dictReadDictReadDictread_dict, write_dictwrite_dictWriteDictWriteDictwrite_dict, serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle, deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle

Modul

Foundation

Operatoren