dictSearch - Man Page

search for value in dictionary.


#include <util/dict.h>
void *dictSearch(dictCtx dict, const char *id, void **plock);


dict - dictionary to search in.
id - identifier of item to find.
plock - place for value lock (or NULL).


Searches for <id> in <dict>, and returns 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.

See Also

dictDestroy(3), dictCleanup(3), dictReleaseLock(3), dictRemove(3), dictNext(3), dictCreate(3), dictSetValue(3), dictModifyValue(3), dictSearch

Referenced By

dictCleanup(3), dictCreate(3), dictDestroy(3), dictModifyValue(3), dictNext(3), dictReleaseLock(3), dictRemove(3), dictSetValue(3).

12 July 2007 ClearSilver util/dict.h