Назва

stpcpy — копіює рядок, повертаючи вказівник на його кінець.

Звід

#include <string.h>
char *stpcpy (char *dest, const char *src);

Опис

Функція stpcpy() копіює рядок, на котрий вказує src (включаючи й завершальний символ «\0»), до масиву, вказаного dest. Рядки не можуть перекриватись, а рядок-приймач dest повинен бути достатньої величини, щоб вмістити копію.

Повернене значення

stpcpy() повертає вказівник на кінець рядка dest (тобто, адресу завершального нульового символа), а не початок.

Приклад

Наприклад, ця програма використовує stpcpy() для зчеплення рядків foo та bar для отримання foobar, що й видруковується в кінці.

#include <string.h>
int 
main(void)
{ 
   char *to = buffer;
   to = stpcpy(to, "foo");
   to = stpcpy(to, "bar");
   printf("%s\n", buffer);
}

Відповідність стандартам

Ця функція не є частиною ані стандарту ANSI, ані POSIX, як також не є вона звичною для систем Unix, проте вона не є й винаходом GNU. Можливо, вона походить з MS-DOS.

Дивіться також

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