strncat()

Concatenate two strings, up to a maximum length

Synopsis:

#include <string.h>

char* strncat( char* dst,
               const char* src,
               size_t n );

Arguments:

dst, src
The strings that you want to concatenate.
n
The maximum number of characters that you want to add from the src string.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The strncat() function appends no more than n characters of the string pointed to by src to the end of the string pointed to by dst. The first character of src overwrites the null character at the end of dst. This function always adds a terminating null character to the result.

Returns:

The same pointer as dst.

Examples:

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

char buffer[80];

int main( void )
  {
    strcpy( buffer, "Hello " );
    strncat( buffer, "world", 8 );
    printf( "%s\n", buffer );
    strncat( buffer, "*************", 4 );
    printf( "%s\n", buffer );
    return EXIT_SUCCESS;
  }

produces the output:

Hello world
Hello world****

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

Last modified: 2013-12-23

comments powered by Disqus