create_dictT_create_dictCreateDictCreateDictcreate_dict创建字典（算子）

名称

create_dictT_create_dictCreateDictCreateDictcreate_dict — 创建一个新的空字典。

签名

描述

create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict 创建一个新的空字典，并将其存储在 DictHandleDictHandleDictHandleDictHandledictHandledict_handle 中。

该字典作为关联数组式的容器，可存储任意数量与唯一键（整数或字符串）关联的值。每个键可指向元组或图标对象。这些对象分别通过 set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple 或 set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object 存储至字典，并可通过 get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple 或 get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object 再次提取。

字典存储的数据始终是原始数据的副本，无论是控制参数还是对象。因此原始数据在调用 set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple 或 set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object 后可立即复用。具体特性如下：

• 对象：副本为引用类型，类似于 copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj。特别地，使用 set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval 或 overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region 算子所做的修改也会影响字典中存储的对象。

• 句柄：将任何句柄存储至字典时，仅复制句柄值而不复制句柄背后的资源。

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。

参数

示例（HDevelop）

Dicts := []
for idx := 0 to 4 by 1
  create_dict (DictHandle)
  Dicts[idx] := DictHandle
endfor
* ...

结果

返回 2 (H_MSG_TRUE)，除非发生资源分配错误。

可能的后继

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object

另见

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object, get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object, get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param

模块

基础