STPCPY(3) | Руководство программиста Linux | 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)
ЗАМЕЧАНИЯ¶
Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
15 марта 2016 г. | GNU |