bfd: Traversing a Hash Table
2.18.3 Traversing a hash table
------------------------------
The function 'bfd_hash_traverse' may be used to traverse a hash table,
calling a function on each element. The traversal is done in a random
order.
'bfd_hash_traverse' takes as arguments a function and a generic 'void
*' pointer. The function is called with a hash table entry (a 'struct
bfd_hash_entry *') and the generic pointer passed to
'bfd_hash_traverse'. The function must return a 'boolean' value, which
indicates whether to continue traversing the hash table. If the
function returns 'FALSE', 'bfd_hash_traverse' will stop the traversal
and return immediately.