[Previous]
[Contents]
[Next]

strcpy(), _fstrcpy()

copy a string

Synopsis:

#include <string.h>

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

Description:

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


Note: Copying of overlapping objects is not guaranteed to work properly. See the description for the memmove() function for information on copying objects that overlap.

The _fstrcpy() function is a data-model-independent form of the strcpy() function. It accepts far pointer arguments, and returns a far pointer. It is most useful in mixed memory model applications.

Returns:

The value of dst.

Examples:

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

void main()
  {
    char buffer[80];

    strcpy( buffer, "Hello " );
    strcat( buffer, "world" );
    printf( "%s\n", buffer );
  }

produces the output:

Hello world

Classification:

strcpy() is ANSI; _fstrcpy() is WATCOM.
Safety:
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

strdup(), strncpy()


[Previous]
[Contents]
[Next]