STPCPY(3)

NOME
stpcpy - copia uma cadeia de caracteres retornando um ponteiro para seu fim

SINÓPSE
#include <string.h>

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

DESCRIÇÃO
A função stpcpy() copia a cadeia de caracteres apontada por src (incluindo o caractere terminal `\0') para a matriz apontada por dest. As cadeias podem não se sobrepor, e a cadeia de destino dest deve ser grande o suficiente para receber a cópia.

VALORES RETORNADOS
stpcpy() retorna um ponteiro para o fim (end) da cadeia dest (isto é, o endereço do caractere terminal nulo) tanto quanto o início.

EXEMPLO
Por exemplo, este programa usa stpcpy para concatenar foo e bar para produzir foobar, o que então será impresso.
          #include <string.h>
          int
          main (void)
          {
            char *to = buffer;
            to = stpcpy (to, "foo");
            to = stpcpy (to, "bar");
            printf ("%s\n", buffer);
          }

DE ACORDO COM
Esta função não é parte dos padrões ANSI ou POSIX e não é usual em sistemas Unix, mas também não é uma invenção de GNU. Talvez ela venha do MS-DOS.

VEJA TAMBÉM
strcpy(3), bcopy(3), memccpy(3), memcpy(3), memmove(3).

TRADUZIDO POR LDP-BR EM 02/07/2001.

  Tradução:
Valter Ferraz Sanches <vfs@ezlinux.cjb.net>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>