dictsearch(3) [debian man page]

dictSearch(3)							    util/dict.h 						     dictSearch(3)

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), dict-
       Search

ClearSilver							   12 July 2007 						     dictSearch(3)

dictCreate(3)							    util/dict.h 						     dictCreate(3)

NAME

       dictCreate  - create new dictionary.

SYNOPSIS

       #include <util/dict.h>

       NEOERR *dictCreate(dictCtx *dict, BOOL threaded, UINT32 root, UINT32 maxLevel,
	   UINT32 flushLimit, BOOL useCase,
	   dictFreeValueFunc freeValue, void *freeRock);

ARGUMENTS

       threaded - true if list should be thread-safe.
       root - performance parameter (see above).
       maxLevel - performance parameter (see above).
       flushLimit - max deleted items to keep cached before
       forcing a flush.
       useCase - true to be case sensitive in identifiers
       freeValue - callback when freeing a value
       freeRock - context for freeValue callback

DESCRIPTION

       Returns	a  dictionary.	 If  <threaded> is true, list is multi-thread safe.  <root>, <maxLevel>, and <flushLimit> act as for skipNewList()
       (see skiplist.h)

       MT-Level: Safe.

RETURN VALUE

       None.

SEE ALSO

       dictDestroy(3), dictCleanup(3), dictReleaseLock(3), dictRemove(3), dictNext(3), dictCreate(3), dictSetValue(3),	dictModifyValue(3),  dict-
       Search

ClearSilver							   12 July 2007 						     dictCreate(3)