strncat.3 - scc - simple c99 compiler
 (HTM) git clone git://git.simple-cc.org/scc
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) Submodules
 (DIR) README
 (DIR) 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