NAME

       array_cat - append one array to another

SYNTAX

       #include <array.h>

       void array_cat(array* x,array* y);

         array x;
         array y;
         array_cat(&x,&y);

DESCRIPTION

       array_cat  appends y to x; i.e., it changes x, allocating more space if necessary, so that
       the initialized bytes in x are the previously initialized bytes in x followed by a copy of
       the initialized bytes in y.

       If x has failed, array_cat has no effect.

       If y has failed, array_cat switches x to have failed.

       If not enough memory is available, array_cat switches x to have failed.

SEE ALSO

       array_allocate(3),    array_get(3),    array_fail(3),    array_reset(3),    array_catb(3),
       array_cats(3), array_cats0(3), array_cate(3)

                                                                                     array_cat(3)