---
name: "dictSearch"
section: "3"
platform: "linux"
package: "clearsilver-dev"
version: "0.10.5-6+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dictSearch"
---

# dictSearch(3)

search for value in dictionary.

## 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)](/dictDestroy/3.md), [**dictCleanup**(3)](/dictCleanup/3.md), [**dictReleaseLock**(3)](/dictReleaseLock/3.md), [**dictRemove**(3)](/dictRemove/3.md), [**dictNext**(3)](/dictNext/3.md), [**dictCreate**(3)](/dictCreate/3.md), [**dictSetValue**(3)](/dictSetValue/3.md), [**dictModifyValue**(3)](/dictModifyValue/3.md), **dictSearch**