radcli_avp_concat_str(3)     Radius client library    radcli_avp_concat_str(3)

NAME
       radcli_avp_concat_str - Concatenate every occurrence of an attribute
       into a bounded buffer.

SYNOPSIS
       #include <radcli/>

       int radcli_avp_concat_str(
           char                   *buf,
           size_t                  buflen,
           const radcli_avp_list  *list,
           const radcli_attr_def  *def,
           const char             *sep
       );

DESCRIPTION
       Generalizes the one convenience legacy radcli.h's rc_aaa() folded into
       its own call signature (its msg parameter: "will contain the

       concatenation of any PW_REPLY_MESSAGE received", lib/buildreq.c) to any
       attribute, since the pattern  walk every occurrence of one attribute in
       a reply, join as text  is not specific to Reply-Message. A caller
       wanting rc_aaa()'s old convenience no longer needs to hand-roll the
       radcli_avp_get()-in-a-loop this replaces.

       If no occurrence of def is present in list, buf is set to an empty
       string and 0 is returned  this is not a failure, the same way
       rc_aaa()'s msg started as ' ' and simply stayed that way when no Reply-
       Message arrived. An attribute whose value contains an embedded NUL
       byte, or (for a RADCLI_TYPE_TEXT attribute) invalid UTF-8, is skipped
       (radcli_avp_get_cstr()'s policy), not treated as a failure either.

       Follows snprintf()'s buffer-sizing contract exactly: buf may be NULL
       and/or buflen may be 0 to size a buffer before allocating one (nothing
       is written in that case), and the return value is always the number of
       bytes the joined result would occupy, whether or not it fit  a return
       >= buflen means the result was truncated, and buf (if non-NULL and
       buflen > 0) then holds only a valid NUL-terminated prefix of what fits,
       never garbage and never unterminated.

PARAMETERS
       buf    destination buffer, or NULL to only compute the needed size;
              always left NUL-terminated on return (including on truncation,
              containing whatever fit), whenever buf is non-NULL and buflen >
              0.


       buflen size of buf, in bytes; may be 0.


       list   the list to search.


       def    the attribute to concatenate occurrences of.


       sep    separator inserted between occurrences; NULL or "" for none.


RETURN VALUE
       the number of bytes the joined result occupies (excluding the NUL
       terminator), whether or not it fit in buf  or -1 if def is NULL.

SEE ALSO
       radcli_avp_add_bytes(3), radcli_avp_add_bytes_by_num(3),
       radcli_avp_add_gigawords64(3), radcli_avp_add_gigawords64_by_num(3),
       radcli_avp_add_ip4(3), radcli_avp_add_ip4_by_num(3),
       radcli_avp_add_ip4prefix(3), radcli_avp_add_ip4prefix_by_num(3),
       radcli_avp_add_ip6(3), radcli_avp_add_ip6_by_num(3),
       radcli_avp_add_str(3), radcli_avp_add_str_by_num(3),
       radcli_avp_add_uint32(3), radcli_avp_add_uint32_by_num(3),
       radcli_avp_add_uint64(3), radcli_avp_add_uint64_by_num(3),
       radcli_avp_add_username(3), radcli_avp_concat_str_by_num(3),
       radcli_avp_def(3), radcli_avp_get(3), radcli_avp_get_by_num(3),
       radcli_avp_get_bytes(3), radcli_avp_get_bytes_by_num(3),
       radcli_avp_get_cstr(3), radcli_avp_get_cstr_by_num(3),
       radcli_avp_get_gigawords64(3), radcli_avp_get_gigawords64_by_num(3),
       radcli_avp_get_ip4prefix(3), radcli_avp_get_ip4prefix_by_num(3),
       radcli_avp_get_ip6(3), radcli_avp_get_ip6_by_num(3),
       radcli_avp_get_uint32(3), radcli_avp_get_uint32_by_num(3),
       radcli_avp_get_uint64(3), radcli_avp_get_uint64_by_num(3),
       radcli_avp_iter_next(3), radcli_avp_list_error(3),
       radcli_avp_list_free(3), radcli_avp_list_iter(3),
       radcli_avp_list_new(3)

radcli                            2026-09-03          radcli_avp_concat_str(3)