programming.nbk: Home | Index | Next Page: strncpy(char *s1, const char *s2, size_t n) | Previous Page: strdup(const char *s1)

 strncat(char *s1, const char *s2, size_t n)

Description

The strncat() function appends up to n characters from string s2 to string s1, and then appends a terminating null character. The initial character of s2 overwrites the null character at the end of s1. Subsequent characters in s2 are appended to s1 until either the end of s2 is reached or n characters have been copied. If copying takes place between objects that overlap, the behavior is undefined.

The function strncat() does not allocate any storage. The caller must insure that the buffer pointed to by s1 is long enough to hold the added characters.

Syntax

char *strncat(char *s1, const char *s2, size_t n)

Parameters

• s1
  Is the null terminated string to be modified.
• s2
  Is the null terminated string to be copied to the end of s1.
• n
  Is the maximum number of characters to append.

Return Values

The strncat() function returns the value of s1.

programming.nbk: Home | Index | Next Page: strncpy(char *s1, const char *s2, size_t n) | Previous Page: strdup(const char *s1)

Notebook exported on Monday, 7 July 2008, 18:56:06 PM Eastern Daylight Time