strcpy()

Copy a string

Synopsis:

#include <string.h>

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

Arguments:

dst

A pointer to where you want to copy the string.

src

The string that you want to copy.

Library:

libc

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

Description:

The strcpy() function copies the string pointed to by src (including the terminating NUL character) into the array pointed to by dst.

Copying of overlapping objects isn't guaranteed to work properly. See the memmove() function for information on copying objects that overlap.

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

See also:

memmove(), strdup(), strncpy(), wcscpy(), wcsncpy(), wmemmove()