Scroll to navigation

stpcpy(3) 2007-10-27-16:31 stpcpy(3)

Назва

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).

2007-10-27-16:31 © 2005-2007 DLOU, GNU FDL