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 `\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)

GNU                     September 3, 1995                       1