prg_bin_hash_table_item_list_get()

Abstract

Gets a list of the items in a hash table.

Syntax

prg_bin_hash_table_item_list_get (hash_ptr)
Argument Type Description
hash_ptr PrgT_Bin_Hash_Table * Hash table of interest.

Return Type

PrgT_List *

List of items in the hash table; PRGC_NIL if the table is empty or an error occurs.

prg_bin_hash.h

Details

This function creates a list and populates it with pointers to the items in the hash table. This is an O(N+M) operation, where N is the number of cells and M is the number of items. This function is intended to support iterating over all of the items in a hash table.

The returned list is created by this function and owned by the caller. The items in the list are pointers to the items in the hash table and should not be freed without first removing the items from the table.

WARNING: This function is MT unsafe, as described in “Multi-Threading Safety“ on page 11. Access to shared hash tables must be externally serialized.

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com