ssttrrnnccaatt() -- String Function (libc)

Append one string onto another
#iinncclluuddee <ssttrriinngg.hh>
cchhaarr *ssttrrnnccaatt(_s_t_r_i_n_g_1, _s_t_r_i_n_g_2, _n)
cchhaarr *_s_t_r_i_n_g_1, *_s_t_r_i_n_g_2; uunnssiiggnneedd _n;

ssttrrnnccaatt() copies up  to _n characters from _s_t_r_i_n_g_2 onto  the end of _s_t_r_i_n_g_1.
It  stops when  _n  characters have  been  copied or  it  encounters a  null
character  in _s_t_r_i_n_g_2,  whichever occurs  first,  and returns  the modified
_s_t_r_i_n_g_1.

_E_x_a_m_p_l_e
For an example of this function, see the entry for ssttrrnnccppyy.

_S_e_e _A_l_s_o
lliibbcc, ssttrrccaatt(), ssttrriinngg.hh
ANSI Standard, section 7.11.3.2
POSIX Standard, section 8.1

_N_o_t_e_s
_s_t_r_i_n_g_1 should  point to enough  space to hold  itself and _n  characters of
_s_t_r_i_n_g_2. If it  does not, a portion of the  program or operating system may
be overwritten.
