ck_hs_next(3) iterate to next entry in hash set

LIBRARY

Concurrency Kit (libck, -lck)

SYNOPSIS

In ck_hs.h Ft bool Fn ck_hs_next ck_hs_t *hs ck_hs_iterator_t *iterator void **entry

DESCRIPTION

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

It is expected that Fa iterator has been initialized using the ck_hs_iterator_init3 function or statically initialized using CK_HS_ITERATOR_INITIALIZER.

RETURN VALUES

If Fn ck_hs_next 3 returns true then the object pointed to by Fa entry points to a valid hash set key. If Fn ck_hs_next 3 returns false then the value of the object pointed to by Fa entry is undefined.

ERRORS

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