Purge hash table.
purge-hash deletes all key/value pairs from <hash> table that was created with
new-hash.
After purge-hash, the hash is empty and you can use it without calling
new-hash again. Note however, that
"average-reads" statistics (see
get-hash) is not reset - it keeps being computed and remains for the life of the hash.
Create hash, put some data in it and then purge the data:
new-hash h size 100
write-hash h key "mykey" value "myvalue"
purge-hash h
See
read-hash for more examples.