NAME    [Toc]    [Back]

       stpcpy - copy a string returning a pointer to its end

SYNOPSIS    [Toc]    [Back]

       #include <string.h>

       char *stpcpy(char *dest, const char *src);

DESCRIPTION    [Toc]    [Back]

       The  stpcpy()  function	copies the string pointed to by src (including
       the terminating `\0' 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    [Toc]    [Back]

       stpcpy() returns a pointer to the end of the string dest (that is,  the
       address of the terminating null character) rather than the beginning.

EXAMPLE    [Toc]    [Back]

       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\n", buffer);
		 }

CONFORMING TO    [Toc]    [Back]

       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    [Toc]    [Back]

       strcpy(3), bcopy(3), memccpy(3), memcpy(3), memmove(3)



GNU				  1995-09-03			     STPCPY(3)