redhat man page for stpcpy

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)