copy_dictT_copy_dictCopyDictCopyDict (Operator)

Name

copy_dictT_copy_dictCopyDictCopyDict — Kopieren eines Dictionaries.

Signatur

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

Beschreibung

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

Wenn DictHandleDictHandleDictHandleDictHandledictHandle ein Handle enthält, das nicht kopiert werden kann oder das schon freigegeben wurde, bricht copy_dictcopy_dictCopyDictCopyDictCopyDict standardmäßig mit einer Fehlermeldung ab. Dieses Verhalten kann durch Setzen von GenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf 'raise_error_if_content_not_serializable' verändert werden, der zugehörige GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue 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 CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandle kopiert und der Kopierprozess weitergeführt. Der Umgang mit HALCON Low-Level-Fehlern wird durch do_low_errordo_low_errordo_low_errordo_low_errordoLowError in set_systemset_systemSetSystemSetSystemSetSystem bestimmt.
'false'"false""false""false""false":: Es werden keine Fehler geworfen. Anstatt des betreffenden Handles wird ein leeres Handle in CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandle 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

DictHandleDictHandleDictHandleDictHandledictHandle (input_control) dict → (handle)

Handle des Dictionaries.

Parameteranzahl: DictHandle == 1

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

Name des generischen Parameters.

Defaultwert: []

Werteliste: 'raise_error_if_content_not_serializable'

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

Wert des generischen Parameters.

Defaultwert: []

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

CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandle (output_control) dict → (handle)

Kopiertes Handle des Dictionaries.

Parameteranzahl: CopiedDictHandle == 1

Ergebnis

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

Vorgänger

read_dictread_dictReadDictReadDictReadDict, deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle, create_dictcreate_dictCreateDictCreateDictCreateDict

Nachfolger

write_dictwrite_dictWriteDictWriteDictWriteDict

Siehe auch

read_dictread_dictReadDictReadDictReadDict, write_dictwrite_dictWriteDictWriteDictWriteDict, serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandle, deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle

Modul

Foundation

Operatoren