NOMBRE

stpcpy - copia una cadena devolviendo un apuntador a su final

SINOPSIS

#include <string.h>

char *stpcpy(char *dest, const char *src);

DESCRIPCIÓN

La función stpcpy() copia la cadena apuntada por src (la cual incluye el caracter `\0' ) a la matriz apuntada por dest. Las cadenas no deben solaparse, y la cadena destino dest tiene que ser lo suficientemente larga para recibir la copia.

VALOR DEVUELTO

stpcpy() devuelve un apuntador al final de la cadena dest (esto es, la dirección del caracter terminador nulo) y no al comienzo.

EJEMPLO

Por ejemplo, este programa usa stpcpy para concatenar foo y bar para prodcir foobar, que entonces se imprime.

          #include <string.h>


          int


          main (void)


          {


            char *to = buffer;


            to = stpcpy (to, "foo");


            to = stpcpy (to, "bar");


            printf ("%s\n", buffer);


          }

CONFORME A

Esta función no es parte de las normas ANSI o POSIX, y no es parte habitual de sistemas UNIX, aunque tampoco es una inveción de GNU. Quizá venga del MS-DOS.

VÉASE TAMBIÉN

strcpy(3), bcopy(3), memccpy(3), memcpy(3), memmove(3)