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.