Poster of Linux kernelThe best gift for a Linux geek
dictNext

dictNext

Section: util/dict.h (3) Updated: 12 July 2007
Local index Up

 

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


 

Index

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
RETURN VALUE
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:45:00 GMT, April 16, 2011