STPCPY(3) Linux Programmer's Manual STPCPY(3)
NAME
stpcpy - copy a string returning a pointer to its end
SYNOPSIS
#include <string.h>
char *stpcpy(char *dest, const char *src);
DESCRIPTION
The stpcpy() function copies the string pointed to by src (including the terminating ` ' character) to the array pointed to by dest. The
strings may not overlap, and the destination string dest must be large enough to receive the copy.
RETURN VALUE
stpcpy() returns a pointer to the end of the string dest (that is, the address of the terminating null character) rather than the begin-
ning.
EXAMPLE
For example, this program uses stpcpy to concatenate foo and bar to produce foobar, which it then prints.
#include <string.h>
int
main (void)
{
char *to = buffer;
to = stpcpy (to, "foo");
to = stpcpy (to, "bar");
printf ("%s
", buffer);
}
CONFORMING TO
This function is not part of the ANSI or POSIX standards, and is not customary on Unix systems, but is not a GNU invention either. Perhaps
it comes from MS-DOS.
SEE ALSO
strcpy(3), bcopy(3), memccpy(3), memcpy(3), memmove(3)
GNU
1995-09-03 STPCPY(3)
