copy_dictT_copy_dictCopyDictCopyDictcopy_dict (Operator)

名称

copy_dictT_copy_dictCopyDictCopyDictcopy_dict — 复制字典。

签名

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

描述

copy_dictcopy_dictCopyDictCopyDictCopyDictcopy_dict creates a deep copy (i.e., all contained handles and iconic objects are deep copied) of the dictionary DictHandleDictHandleDictHandleDictHandledictHandledict_handle in the dictionary CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle.

If DictHandleDictHandleDictHandleDictHandledictHandledict_handle contains a handle that can not be copied or that has been freed already, an exception is raised per default. This behavior is controlled by GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 'raise_error_if_content_not_serializable', and the corresponding GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value can take the following values:

'true'"true""true""true""true""true":: The default: Errors are raised and the copy process aborted.
'low_level'"low_level""low_level""low_level""low_level""low_level":: Only low level errors are raised. Instead of the handle concerned an empty handle is copied in CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle and the copy process will be continued. The behavior regarding HALCON low level errors is determined by 'do_low_error'"do_low_error""do_low_error""do_low_error""do_low_error""do_low_error" in set_systemset_systemSetSystemSetSystemSetSystemset_system.
'false'"false""false""false""false""false":: The errors are suppressed. Instead of the handle concerned an empty handle is copied in CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle and the copy process will be continued.

执行信息

Multithreading type: independent (runs in parallel even with exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

参数

DictHandleDictHandleDictHandleDictHandledictHandledict_handle (input_control) dict → (handle)

Dictionary handle.

元素数量： DictHandle == 1

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

Name of the generic parameter.

默认值： []

值列表： 'raise_error_if_content_not_serializable'

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

Value of the generic parameter.

默认值： []

建议值： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'low_level'"low_level""low_level""low_level""low_level""low_level"

CopiedDictHandleCopiedDictHandleCopiedDictHandleCopiedDictHandlecopiedDictHandlecopied_dict_handle (output_control) dict → (handle)

Copied dictionary handle.

元素数量： CopiedDictHandle == 1

结果

If the parameters are valid, the operator copy_dictcopy_dictCopyDictCopyDictCopyDictcopy_dict returns the value 2 ( H_MSG_TRUE) . If necessary an exception is raised.

可能的前置算子

read_dictread_dictReadDictReadDictReadDictread_dict, deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle, create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict

可能的后继算子

write_dictwrite_dictWriteDictWriteDictWriteDictwrite_dict

另见

read_dictread_dictReadDictReadDictReadDictread_dict, write_dictwrite_dictWriteDictWriteDictWriteDictwrite_dict, serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle, deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle

模块

Foundation

算子