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)


Man(1) output converted with man2html