SS8_CAT(3)                       Ssstr Manual                       SS8_CAT(3)



NAME
       ss8_cat,  ss8_cat_cstr,  ss8_cat_bytes, ss8_cat_ch, ss8_cat_ch_n - con‐
       catenate a string or characters to an ssstr byte string

SYNOPSIS
       #include <ss8str.h>

       ss8str *ss8_cat(ss8str *restrict dest,
                       ss8str const *restrict src);
       ss8str *ss8_cat_cstr(ss8str *restrict dest,
                       char const *restrict src);
       ss8str *ss8_cat_bytes(ss8str *restrict dest,
                       char const *restrict src, size_t srclen);
       ss8str *ss8_cat_ch(ss8str *dest, char ch);
       ss8str *ss8_cat_ch_n(ss8str *dest, char ch, size_t count);

DESCRIPTION
       ss8_cat() appends the ss8str at src to the end of the ss8str  at  dest.
       Behavior is undefined unless dest and src point to a valid and distinct
       ss8str objects.

       ss8_cat_cstr() appends the null-terminated byte string src to  the  end
       of  the  ss8str at dest.  Behavior is undefined unless dest points to a
       valid ss8str object and src is a null-terminated byte string that  does
       not overlap with the internal buffer of dest.

       ss8_cat_bytes() appends the byte string of length srclen located at src
       to the end of the ss8str at dest.  Behavior is  undefined  unless  dest
       points  to a valid ss8str object and src points to an array of at least
       srclen bytes that does not overlap with the internal buffer of dest.

       ss8_cat_ch() appends the single byte ch to the end  of  the  ss8str  at
       dest.   Behavior  is undefined unless dest points to a valid ss8str ob‐
       ject.

       ss8_cat_ch_n() appends count copies of the byte ch to the  end  of  the
       ss8str  at  dest.   Behavior is undefined unless dest points to a valid
       ss8str object.

RETURN VALUE
       All 5 functions return dest.

SEE ALSO
       ss8_copy(3), ss8_insert(3), ssstr(7)



SSSTR                             2023-12-30                        SS8_CAT(3)