NAME

radcli_avp_get_cstr_by_num - Look up an attribute by legacy numeric ID and read its first occurrence as a NUL-terminated string.

SYNOPSIS

#include <radcli/>

const char * radcli_avp_get_cstr_by_num(
    const radcli_avp_list  *list,
    const radcli_ctx       *ctx,
    uint32_t                attrid,
    uint32_t                vendor
);

DESCRIPTION

PARAMETERS

list

the list to search.

ctx

a context with a dictionary loaded.

attrid

the attribute ID (a PW_* constant, or a vendor type ID when vendor is non-zero).

vendor

the vendor PEN, or 0 for a standard attribute.

RETURN VALUE

a pointer valid for list's lifetime (owned by list never freed by the caller), or NULL if no such attribute is defined, no occurrence exists, or as radcli_avp_get_cstr() (embedded NUL byte, or invalid UTF-8 for a RADCLI_TYPE_TEXT attribute).

SEE ALSO

radcli_avp_get_by_num(3), radcli_avp_get_bytes_by_num(3), radcli_avp_get_ip4prefix_by_num(3), radcli_avp_get_ip6_by_num(3), radcli_avp_get_uint32_by_num(3), radcli_avp_get_uint64_by_num(3)