chtbl_destroy
Destroys the chained hash table specified by
htbl
. No other operations are permitted
after calling chtbl_destroy unless
chtbl_init is called again. The
chtbl_destroy operation removes all elements
from a hash table and calls the function passed as
destroy
to
chtbl_init once for each element as it is
removed, provided destroy
was not set
to NULL.