Namespaces
Variants
Views
Actions

strncat

From cppreference.com
< c‎ | string‎ | byte
Revision as of 11:59, 7 May 2013 by Pusni (Talk | contribs)

Template:ddcl list begin <tr class="t-dsc-header">

<td>
Defined in header <string.h>
</td>

<td></td> <td></td> <tr class="t-dcl-sep"><td></td><td></td><td></td></tr>

<tr class="t-dcl ">

<td >
char *strncat( char          *dest, const char          *src, size_t count );
</td>

<td class="t-dcl-nopad"> </td> <td > (until C99) </td> </tr> <tr class="t-dcl-sep"><td></td><td></td><td></td></tr>

<tr class="t-dcl ">

<td >
char *strncat( char *restrict dest, const char *restrict src, size_t count );
</td>

<td class="t-dcl-nopad"> </td> <td > (since C99) </td> </tr> Template:ddcl list end

Appends a byte string pointed to by src to a byte string pointed to by dest. At most count characters from src are copied. The resulting byte string is null-terminated.

The destination byte string must have enough space for the contents of both dest and src plus the terminating null character, except that the size of src is limited to count.

The behavior is undefined if the strings overlap.

Contents

Parameters

dest - pointer to the null-terminated byte string to append to
src - pointer to the null-terminated byte string to copy from
count - maximum number of characters to copy

Return value

dest

Example

#include <string.h> 
#include <stdio.h>
 
int main() 
{
    char str[50] = "Hello ";
    char str2[50] = "World!";
    strcat(str, str2);
    strncat(str, " Goodbye World!", 3);
    puts(str);
}

Output:

Hello World! Go

See also

Template:c/string/byte/dcl list strcatTemplate:c/string/byte/dcl list strcpy
C++ documentation for strncat