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

Environment variables:

LD_PRELOAD
To use the implementation for this function that's optimized for ARM 64-bit architecture, you must set this environment variable. For example:
# export LD_PRELOAD=/lib/libstringsa64.so
            

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler Read the Caveats
Signal handler Yes
Thread Yes

Caveats:

If you're using the implementation for this function that's optimized for ARM 64-bit architecture, it's unsafe to use it in an interrupt handler.