STPCPY(3)

ИМЯ
stpcpy - копирование строки с возвращением указателя на её конец

ОБЗОР
#include <string.h>

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

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

stpcpy():
    Начиная с glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    До glibc 2.10:
        _GNU_SOURCE

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

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция stpcpy() возвращает указатель на конец строки dest (то есть адрес конечного байта null), а не на её начало.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
stpcpy() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
Эта функция была добавлена в POSIX.1-2008. До этого, она не была частью стандарта C или POSIX.1, или обычной для систем UNIX. Впервые она появилась не раньше 1986 года в компиляторе Lattice C AmigaDOS, затем в GNU fileutils и GNU textutils в 1989 году, и в библиотеке GNU C в 1992 году. Также она есть в разных BSD.

ДЕФЕКТЫ
Эта функция может переполнить буфер dest.

ПРИМЕР
Данная программа использует stpcpy() для объединения foo и bar, чтобы получить строку foobar, которая затем выводится.

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

СМОТРИТЕ ТАКЖЕ
bcopy(3), memccpy(3), memcpy(3), memmove(3), stpncpy(3), strcpy(3), string(3), wcpcpy(3)