stpcpy

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                               1995-09-03                         STPCPY(3)