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),