.TH dictNext 3 "12 July 2007" "ClearSilver" "util/dict.h".de Ss.sp.ft CW.nf...de Se.fi.ft P.sp...SH NAMEdictNext  - search for next value in dictionary..SH SYNOPSIS.Ss#include <util/dict.h>.Se.Ssvoid *dictNext(dictCtx dict, char **id, void **plock);.Se.SH ARGUMENTSdict - dictionary to iterate over..brid - pointer to identifier of last item found, or.brpointer to NULL to retrieve first..brplock - place for value lock (or NULL)..SH DESCRIPTIONCan be used to iterate through values in the dictionary.The order is the order of the hash of the ids, whichisn't usefully externally.  Will return the value if found, or NULL if not.  If <plock> is non-NULL, thenthe lock returned in <plock> will be associated withthe returned value.  Until this lock is passed todictReleaseLock(), the value will not be passed to thedictCleanupFunc callback (see dictCleanup()).MT-Level: Safe if <dict> thread-safe..SH "RETURN VALUE"plock - set to value lock..brid - pointer to id of found value.SH "SEE ALSO".BR dictDestroy "(3), "dictCleanup "(3), "dictReleaseLock "(3), "dictRemove "(3), "dictNext "(3), "dictCreate "(3), "dictSetValue "(3), "dictModifyValue "(3), "dictSearch