ck_ht_next(3) iterate to next entry in hash table

LIBRARY

Concurrency Kit (libck, -lck)

SYNOPSIS

In ck_ht.h Ft bool Fn ck_ht_next ck_ht_t *ht ck_ht_iterator_t *iterator ck_ht_entry_t **entry

DESCRIPTION

The Fn ck_ht_next function will increment the iterator object pointed to by Fa iterator to point to the next non-empty hash table entry. If Fn ck_ht_next returns true then the pointer pointed to by Fa entry is initialized to the current hash table entry pointed to by the Fa iterator object.

It is expected that Fa iterator has been initialized using the ck_ht_iterator_init3 function or statically initialized using CK_HT_ITERATOR_INITIALIZER.

RETURN VALUES

If Fn ck_ht_next returns true then the object pointed to by Fa entry points to a valid hash table entry. If Fn ck_ht_next returns false then value of the object pointed to by Fa entry is undefined.

ERRORS

Behavior is undefined if Fa iterator or Fa ht are uninitialized.