NAME
dictNext - search for next value in dictionary.
SYNOPSIS
#include <util/dict.h>
void *dictNext(dictCtx dict, char **id, void **plock);
ARGUMENTS
dict - dictionary to iterate over.
id - pointer to identifier of last item found, or
pointer to NULL to retrieve first.
plock - place for value lock (or NULL).
DESCRIPTION
Can be used to iterate through values in the dictionary. The order is
the order of the hash of the ids, which isn’t usefully externally.
Will return the value if found, or NULL if not. If <plock> is non-
NULL, then the lock returned in <plock> will be associated with the
returned value. Until this lock is passed to dictReleaseLock(), the
value will not be passed to the dictCleanupFunc callback (see
dictCleanup()).
MT-Level: Safe if <dict> thread-safe.
RETURN VALUE
plock - set to value lock.
id - pointer to id of found value
SEE ALSO
dictDestroy(3), dictCleanup(3), dictReleaseLock(3), dictRemove(3),
dictNext(3), dictCreate(3), dictSetValue(3), dictModifyValue(3),
dictSearch