---
name: "radcli_dict_lookup_value"
section: "3"
platform: "linux"
package: "radcli"
version: "2.0.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/radcli_dict_lookup_value"
---

# radcli\_dict\_lookup\_value(3)

Resolve a dictionary VALUE by name, scoped to one attribute.

## NAME

radcli\_dict\_lookup\_value - Resolve a dictionary VALUE by name, scoped to one attribute.

## SYNOPSIS

```
#include <radcli/>

int radcli_dict_lookup_value(
    const radcli_ctx       *ctx,
    const radcli_attr_def  *def,
    const char             *name,
    uint32_t               *out
);
```

## DESCRIPTION

The runtime, VALUE-name counterpart to radcli\_dict\_lookup(): covers a vendor-specific or supplemental-dictionary VALUE with no compiled-in constant in radcli-defs.h (which only covers RFC 2865/2866/2869 standard VALUEs). A VALUE name is only meaningful together with the attribute it was defined under  two different attributes may each define a VALUE named e.g. "Yes"  so def fixes that scope, the same way radcli\_dict\_value\_by\_attr()/rc\_dict\_getval() already scope a numeric VALUE lookup by attribute rather than matching across the whole dictionary.

## PARAMETERS

- **ctx**

  a context with a dictionary loaded.

- **def**

  the attribute the VALUE belongs to, from radcli\_dict\_lookup() or a sibling.

- **name**

  the VALUE's name, as it appears in a VALUE dictionary line.

- **out**

  the VALUE's numeric value, set only on success.

## RETURN VALUE

0 on success, -1 if ctx/def/name/out is NULL or no such VALUE is defined for def.

## SEE ALSO

[*radcli\_attr\_def\_name*(3)](/radcli_attr_def_name/3.md), [*radcli\_attr\_def\_oid*(3)](/radcli_attr_def_oid/3.md), [*radcli\_attr\_def\_type*(3)](/radcli_attr_def_type/3.md), [*radcli\_dict\_lookup*(3)](/radcli_dict_lookup/3.md), [*radcli\_dict\_lookup\_num*(3)](/radcli_dict_lookup_num/3.md), [*radcli\_dict\_lookup\_oid*(3)](/radcli_dict_lookup_oid/3.md)