prg_bin_hash_table_destroy()
Abstract
Destroys a hash table and frees its memory.
Syntax
prg_bin_hash_table_destroy (hash_ptr, dealloc_proc)
| Argument | Type | Description |
|---|---|---|
hash_ptr |
PrgT_Bin_Hash_Table * |
Hash table to be destroyed. |
dealloc_proc |
PrgT_Bin_Hash_Elem_Dealloc_Proc |
User-defined procedure to destroy the values in the hash table. |
Return Type
void
No return value.
Header
prg_bin_hash.h
Details
This function calls dealloc_proc for each cell of the hash table before deallocating the memory used by the cell. The prototype for dealloc_proc is given in PrgT_Bin_Hash_Elem_Dealloc_Proc.
WARNING: This function is MT unsafe, as described in “Multi-Threading Safety“ on page 11. Access to shared hash tables must be externally serialized.