prg_string_hash_table_keys_get()

Abstract

Returns a list of all the keys in a hash table.

Syntax

prg_string_hash_table_keys_get (hash_table_ptr)
Argument Type Description
hash_table_ptr PrgT_Sting_Hash_Table * Pointer to the hash table of interest.

Return Type

PrgT_List *

List of all the keys in the hash table.

prg_string_hash_funcs.h

Details

This function returns a list of keys that have been inserted into the hash table. Typically, this is used to efficiently iterate over all of the objects contained in the hash table.

This function returns allocated copies of the key strings in the hash table. Thus, the client must destroy both the returned key strings and list when no longer needed. Failure to do so can lead to memory leaks.

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