prg_string_hash_table_free_proc()
Abstract
Destroys a hash table and the values contained within it.
Syntax
prg_string_hash_table_free_proc (hash_table_ptr, dealloc_proc)
| Argument | Type | Description |
|---|---|---|
hash_table_ptr |
PrgT_String_Hash_Table * |
Pointer to the hash table to be destroyed. |
dealloc_proc |
PrgT_Hash_Cell_Dealloc_Proc |
User-defined procedure to destroy the values in the hash table. |
Return Type
void
No return value.
Header
prg_string_hash_funcs.h
Details
This function calls dealloc_proc for each cell of the hash table before deallocating the memory used by the cell. The prototype of dealloc_proc is given in PrgT_Hash_Cell_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.