DragonFly On-Line Manual Pages

ght_next(3)                 libghthash User Manual                 ght_next(3)

NAME
       ght_next - return the next element in an iteration

SYNOPSIS
       #include <ght_hash_table.h>

       void *ght_next(ght_hash_table_t *p_ht, ght_iterator_t *p_it, void
       **pp_key);

DESCRIPTION
       Return the next element in an iteration.  p_ht is the hash table to
       iterate in, p_it is a pointer to the iterator to initialize, and pp_key
       is filled in with a pointer to the key for the current item.

       This function should be used for iteration, and must be called after
       ght_first.

       The use of the ght_iterator_t allows for several concurrent iterations,
       where you would use one ght_iterator_t for each iteration. In threaded
       environments, you should still lock access to the hash table for
       insertion and removal.

WARNING
       Calling this without first having called ght_first will give undefined
       results (probably a crash), since the iterator isn't filled correctly.

SEE ALSO
       ght_first(3),

       libghthash is fully documented with Doxygen (in
       {prefix}/doc/libghthash/html/).

AUTHOR
       This manual page was created by Simon Kagstrom <ska@bth.se>.

libghthash                        2005-07-21                       ght_next(3)