ИМЯ

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);
}

ИМЯ