1dictNext(3)                       util/dict.h                      dictNext(3)
2
3
4

NAME

6       dictNext  - search for next value in dictionary.
7

SYNOPSIS

9       #include <util/dict.h>
10
11
12       void *dictNext(dictCtx dict, char **id, void **plock);
13
14
15
16

ARGUMENTS

18       dict - dictionary to iterate over.
19       id - pointer to identifier of last item found, or
20       pointer to NULL to retrieve first.
21       plock - place for value lock (or NULL).
22
23

DESCRIPTION

25       Can  be used to iterate through values in the dictionary.  The order is
26       the order of the hash of the  ids,  which  isn't  usefully  externally.
27       Will  return  the  value  if found, or NULL if not.  If <plock> is non-
28       NULL, then the lock returned in <plock> will  be  associated  with  the
29       returned  value.   Until  this lock is passed to dictReleaseLock(), the
30       value will not be passed to the  dictCleanupFunc  callback  (see  dict‐
31       Cleanup()).
32
33       MT-Level: Safe if <dict> thread-safe.
34
35

RETURN VALUE

37       plock - set to value lock.
38       id - pointer to id of found value
39
40

SEE ALSO

42       dictDestroy(3),   dictCleanup(3),   dictReleaseLock(3),  dictRemove(3),
43       dictNext(3), dictCreate(3), dictSetValue(3), dictModifyValue(3),  dict‐
44       Search
45
46
47
48ClearSilver                      12 July 2007                      dictNext(3)
Impressum