dictsearch(3) - Linux man page

Name

dictSearch - search for value in dictionary.

Synopsis

#include <util/dict.h>

void *dictSearch(dictCtx dict, const char *id, void **plock);

Arguments

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

Description

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