Provided by: manpages-pt-dev_20040726-4_all bug

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 ‘\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

       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

       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

       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)