strncat


function
<cstring>
char * strncat ( char * destination, char * source, size_t num );

Append characters from string

Appends the first num characters of source to destination, plus a terminating null-character. If the length of the C string in source is less than num, only the content up to the terminating null-character is copied.

Parameters

destination
Pointer to the destination array, which should contain a C string, and be large enough to contain the concatenated resulting string, including the additional null-character.
source
C string to be appended.
num
Maximum number of characters to be appended.


Return Value

destination is returned.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
/* strncat example */
#include <stdio.h>
#include <string.h>

int main ()
{
  char str1[20];
  char str2[20];
  strcpy (str1,"To be ");
  strcpy (str2,"or not to be");
  strncat (str1, str2, 6);
  puts (str1);
  return 0;
}


Output:

To be or not


See also

strcat Concatenate strings (function)
strncpy Copy characters from string (function)
memcpy Copy block of memory (function)