Halcon Dict相关算子(一)

(1) create_dict( : : : DictHandle)

功能：创建一个新的空字典。

控制输出参数：DictHandle：新创建的字典句柄。

(2) set_dict_tuple( : : DictHandle, Key, Tuple : )

功能：向字典中添加一组键值(元组)对。

控制输入参数1：DictHandle：字典句柄；

控制输入参数2：Key：键字符串；

控制输入参数3：Tuple：与键相对应的元组值。

(3) get_dict_tuple( : : DictHandle, Key : Tuple)

功能：从字典中检索与键相关联的元组值。

控制输入参数1：DictHandle：字典句柄；

控制输入参数2：Key： 键字符串；

控制输出参数：Tuple：从字典中检索的元组值。

(4) get_dict_param( : : DictHandle, GenParamName, Key : GenParamValue)

功能：查询字典参数的当前值或字典状态的其他信息。

控制输入参数1：DictHandle：字典句柄；

控制输入参数2：GenParamName：字典参数或info查询的名称；List of values: 'key_data_type', 'key_exists', 'keys'，

'keys'：查询字典中存储的所有键，参数Key必须是一个空元组；

'key_exists'：如果给定的键存储在字典中，报告1，否则报告0。结果通过GenParamValue报告，每个键对应一个值；

控制输入参数3：Key：字典键(当GenParamName = 'keys'为空)；

控制输出参数：GenParamValue：字典参数或者信息查询的值。

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

功能：对字典进行复制。

控制输入参数1：DictHandle：字典句柄；

控制输入参数2：GenParamName：通用参数的名称，Default value: []；

控制输入参数3：GenParamValue：通用参数的值，Default value: []；

控制输出参数：CopiedDictHandle：已复制的字典句柄。

(6) remove_dict_key( : : DictHandle, Key : )

功能：从字典中删除Key中指定的键，并释放与这些键相关的所有(元组或对象)数据。

控制输入参数：DictHandle：字典句柄；

控制输出参数：Key：待删除的键。

(7) read_dict( : : FileName, GenParamName, GenParamValue : DictHandle)

功能：从文件中读取字典。

控制输入参数1：FileName：文件名，File extension: .hdict；

控制输入参数2：GenParamName：通用参数的名称，Default value: []；

控制输入参数3：GenParamValue：通用参数的值，Default value: []。

控制输出参数：DictHandle：字典句柄；

(8) write_dict( : : DictHandle, FileName, GenParamName, GenParamValue : )

功能：将字典写入文件中。

控制输入参数1：DictHandle：字典句柄；

控制输入参数2：FileName：文件名，File extension: .hdict；

控制输入参数3：GenParamName：通用参数的名称，Default value: []；

控制输入参数4：GenParamValue：通用参数的值，Default value: []。