Operating systems, development tools, and professional
services for connected embedded systems
Home
Developer Resources

strcat

PDF Documents
More resources

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()

 
©2013 QNX Software Systems Limited, a subsidiary of BlackBerry.   BlackBerry Logo