stpcpy - копирует строку, устанавливая указатель на ее конец

НАЗВАНИЕ
stpcpy - копирует строку, устанавливая указатель на ее
конец

СИНТАКСИС
#include

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

ОПИСАНИЕ
Функция stpcpy() копирует строку src (включая строку,
заканчивающуюся сиволом `\0') в массив dest. Строки не
должны пересекаться, а строка dest должна быть достаточно
большой для приема данной копии.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
stpcpy() возвращает указатель на конец строки dest (т.е.
на адрес завершающего нуль-символа), а не на начало.

ПРИМЕР
Эта программа использует stpcpy для сложения foo и bar,
чтобы получить foobar, которая выводится ими впоследствии.
int
main (void)
{
char *to = buffer;
to = stpcpy (to, "foo");
to = stpcpy (to, "bar");
printf ("%s\n", buffer);
}

СООТВЕТСТВИЕ СТАНДАРТАМ
Эта функция не описана в стандартах ANSI и POSIX, не
используется в системах Unix и не является изобретением,
входящим в GNU. Возможно, она использовалась в MS-DOS.