prg_bin_hash_table_item_list_get()
摘要
获取哈希表中条目的列表。
语法
prg_bin_hash_table_item_list_get (hash_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
hash_ptr |
PrgT_Bin_Hash_Table * |
目标哈希表。 |
返回类型
PrgT_List *
哈希表中条目的列表;如果表为空或发生错误,则返回 PRGC_NIL。
头文件
prg_bin_hash.h
详情
该函数创建一个列表,并用指向哈希表中各条目的指针填充该列表。这是一个 O(N+M) 操作,其中 N 是单元数,M 是条目数。该函数用于支持遍历哈希表中的所有条目。
返回的列表由该函数创建,并由调用者拥有。列表中的条目是指向哈希表中条目的指针,在未先将条目从表中移除之前不应释放。
**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享哈希表的访问必须由外部串行化。