scc

simple c99 compiler
git clone git://git.simple-cc.org/scc
Log | Files | Refs | Submodules | README | LICENSE

strncat.3 (839B)

      1 .TH strncat 3
      2 .SH NAME
      3 strncat - concatenate a string with a part of another
      4 .SH SYNOPSIS
      5 #include <string.h>
      6 
      7 char *strncat(char *restrict s1, const char *restrict s2, size_t n)
      8 .SH DESCRIPTION
      9 The
     10 .BR strncat ()
     11 function appends not more than n characters
     12 (a null character and characters that follow are not appended)
     13 from the array pointed to by
     14 .I s2
     15 to the end of the string pointed to by
     16 .IR s1 .
     17 .PP
     18 The initial character of
     19 .I s2
     20 overwrites the null character
     21 at the end of
     22 .IR s1 .
     23 .PP
     24 A terminating null character is always appended to the result.
     25 The function shall not append anything to
     26 .I s1
     27 if
     28 .I n
     29 is equal to 0.
     30 If copying takes place between objects that overlap,
     31 the behaviour is undefined.
     32 .SH RETURN VALUE
     33 The
     34 .BR strncat ()
     35 function shall return the pointer
     36 .IR s1 .
     37 .SH STANDARDS
     38 ISO/IEC 9899:1999 Section 7.21.3.2