Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

strcat()

Concatenate two strings

Synopsis:

#include <string.h>

char* strcat( char* dst, 
              const char* src );

Arguments:

dst, src
The strings that you want to concatenate.

Library:

libc

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

Description:

The strcat() function appends a copy of the string pointed to by src (including the terminating NUL character) to the end of the string pointed to by dst. The first character of src overwrites the NUL character at the end of dst.

Returns:

The same pointer as dst.

Examples:

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

int main( void )
{
    char buffer[80];

    strcpy( buffer, "Hello " );
    strcat( buffer, "world" );

    printf( "%s\n", buffer );
    
    return EXIT_SUCCESS;
}

produces the output:

Hello world

Classification:

ANSI, POSIX 1003.1

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

See also:

strncat(), strncpy(), strcpy()