radcli_avp_get3
Find the idx-th occurrence of an attribute in a list.
Usage
#include <radcli/>
const radcli_avp * radcli_avp_get(
const radcli_avp_list *list,
const radcli_attr_def *def,
unsigned idx
);
Overview
Parameters
|
the list to search. |
|---|---|
|
the attribute to look for. |
|
0 for the first occurrence, 1 for the second, and so on. |
Return value
the matching attribute, or NULL if fewer than idx+1 occurrences exist.
See also
radcli_avp_add_bytes(3)
Append an attribute holding an arbitrary byte string.
radcli_avp_add_bytes_by_num(3)
Look up an attribute by legacy numeric ID and append its bytes.
radcli_avp_add_gigawords64(3)
Append a 64-bit counter as an Octets/Gigawords attribute pair.
radcli_avp_add_gigawords64_by_num(3)
Look up the octets attribute by legacy numeric ID and append a 64-bit counter as an Octets/Gigawords pair.
radcli_avp_add_ip4(3)
Append an IPv4-address-typed attribute from a struct in_addr.
radcli_avp_add_ip4_by_num(3)
Look up an IPv4-address-typed attribute by legacy numeric ID and append it.
radcli_avp_add_ip4prefix(3)
Append an IPv4-prefix-typed attribute.
radcli_avp_add_ip4prefix_by_num(3)
Look up an IPv4-prefix-typed attribute by legacy numeric ID and append it.
radcli_avp_add_ip6(3)
Append an IPv6-address or IPv6-prefix-typed attribute.
radcli_avp_add_ip6_by_num(3)
Look up an IPv6-address or IPv6-prefix-typed attribute by legacy numeric ID and append it.
radcli_avp_add_str(3)
Append a string- or text-typed attribute.
radcli_avp_add_str_by_num(3)
Look up a string-typed attribute by legacy numeric ID and append it.
radcli_avp_add_uint32(3)
Append an integer/IPv4-address/date-typed attribute.
radcli_avp_add_uint32_by_num(3)
Look up an integer/IPv4-address/date-typed attribute by legacy numeric ID and append it.
radcli_avp_add_uint64(3)
Append a 64-bit integer- or ifid-typed attribute.
radcli_avp_add_uint64_by_num(3)
Look up a 64-bit integer-typed attribute by legacy numeric ID and append it.
radcli_avp_add_username(3)
Append a User-Name AVP, appending a realm as "username@realm" unless username already contains one.
radcli_avp_concat_str(3)
Concatenate every occurrence of an attribute into a bounded buffer.
radcli_avp_concat_str_by_num(3)
Look up an attribute by legacy numeric ID and concatenate every occurrence into a bounded buffer.
radcli_avp_def(3)
Return the attribute definition of a.
radcli_avp_get_by_num(3)
Look up the idx-th occurrence of an attribute by legacy numeric ID.
radcli_avp_get_bytes(3)
Read an attribute's value as raw bytes.
radcli_avp_get_bytes_by_num(3)
Look up an attribute by legacy numeric ID and read its first occurrence's raw bytes.
radcli_avp_get_cstr(3)
Read an attribute's value as a NUL-terminated string, with no allocation or copy.
radcli_avp_get_cstr_by_num(3)
Look up an attribute by legacy numeric ID and read its first occurrence as a NUL-terminated string.
radcli_avp_get_gigawords64(3)
Reassemble a 64-bit counter from an Octets/Gigawords attribute pair.
radcli_avp_get_gigawords64_by_num(3)
Look up the octets attribute by legacy numeric ID and reassemble a 64-bit counter from an Octets/Gigawords pair.
radcli_avp_get_ip4prefix(3)
Read an attribute's value as an IPv4 prefix.
radcli_avp_get_ip4prefix_by_num(3)
Look up an IPv4-prefix-typed attribute by legacy numeric ID and read its first occurrence.
radcli_avp_get_ip6(3)
Read an attribute's value as an IPv6 address or prefix.
radcli_avp_get_ip6_by_num(3)
Look up an IPv6-address or IPv6-prefix-typed attribute by legacy numeric ID and read its first occurrence.
radcli_avp_get_uint32(3)
Read an attribute's value as an integer/IPv4-address/date.
radcli_avp_get_uint32_by_num(3)
Look up an integer/IPv4-address/date-typed attribute by legacy numeric ID and read its first occurrence.
radcli_avp_get_uint64(3)
Read an attribute's value as a 64-bit integer or ifid.
radcli_avp_get_uint64_by_num(3)
Look up a 64-bit integer-typed attribute by legacy numeric ID and read its first occurrence.
radcli_avp_iter_next(3)
Return the current attribute and advance.
radcli_avp_list_error(3)
Check whether any radcli_avp_add_*()/_by_num() call on list has ever failed.
radcli_avp_list_free(3)
Free a list and every attribute it holds.
radcli_avp_list_iter(3)
Begin iterating list.
radcli_avp_list_new(3)
Create an empty attribute-value pair list.
Referred to by
radcli2.h(3)
radcli_avp_def(3)
Return the attribute definition of a.
radcli_avp_add_ip4(3)
Append an IPv4-address-typed attribute from a struct in_addr.
radcli_avp_add_ip6(3)
Append an IPv6-address or IPv6-prefix-typed attribute.
radcli_avp_add_str(3)
Append a string- or text-typed attribute.
radcli_avp_get_ip6(3)
Read an attribute's value as an IPv6 address or prefix.
radcli_avp_get_cstr(3)
Read an attribute's value as a NUL-terminated string, with no allocation or copy.
radcli_avp_list_new(3)
Create an empty attribute-value pair list.
radcli_avp_add_bytes(3)
Append an attribute holding an arbitrary byte string.
radcli_avp_get_bytes(3)
Read an attribute's value as raw bytes.
radcli_avp_iter_next(3)
Return the current attribute and advance.
radcli_avp_list_free(3)
Free a list and every attribute it holds.
radcli_avp_list_iter(3)
Begin iterating list.
radcli_avp_add_uint32(3)
Append an integer/IPv4-address/date-typed attribute.
radcli_avp_add_uint64(3)
Append a 64-bit integer- or ifid-typed attribute.
radcli_avp_concat_str(3)
Concatenate every occurrence of an attribute into a bounded buffer.
radcli_avp_get_uint32(3)
Read an attribute's value as an integer/IPv4-address/date.
radcli_avp_get_uint64(3)
Read an attribute's value as a 64-bit integer or ifid.
radcli_avp_list_error(3)
Check whether any radcli_avp_add_*()/_by_num() call on list has ever failed.
radcli_avp_add_username(3)
Append a User-Name AVP, appending a realm as "username@realm" unless username already contains one.
radcli_avp_add_ip4prefix(3)
Append an IPv4-prefix-typed attribute.
radcli_avp_get_ip4prefix(3)
Read an attribute's value as an IPv4 prefix.
radcli_avp_add_gigawords64(3)
Append a 64-bit counter as an Octets/Gigawords attribute pair.
radcli_avp_get_gigawords64(3)
Reassemble a 64-bit counter from an Octets/Gigawords attribute pair.
radcli_avp_concat_str_by_num(3)
Look up an attribute by legacy numeric ID and concatenate every occurrence into a bounded buffer.
radcli_avp_add_gigawords64_by_num(3)
Look up the octets attribute by legacy numeric ID and append a 64-bit counter as an Octets/Gigawords pair.
radcli_avp_get_gigawords64_by_num(3)
Look up the octets attribute by legacy numeric ID and reassemble a 64-bit counter from an Octets/Gigawords pair.