Scroll to navigation

STRDUP(3) Руководство программиста Linux STRDUP(3)

ИМЯ

strdup, strndup, strdupa, strndupa - дублирование строки

СИНТАКСИС

#include <string.h>
char *strdup(const char *s);
char *strndup(const char *s, size_t n);
char *strdupa(const char *s);
char *strndupa(const char *s, size_t n);

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

strdup():

_XOPEN_SOURCE >= 500
|| /* начиная с glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
|| /* в версии glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

strndup():

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

strdupa(), strndupa(): _GNU_SOURCE

ОПИСАНИЕ

Функция strdup() возвращает указатель на новую строку, являющуюся дубликатом строки s. Память под новую строку выделятся с помощью malloc(3) и может быть высвобождены с помощью free(3).

Функция strndup() похожа на предыдущую, но копирует не более n байт. Если s длиннее n, то копируется только n байт и добавляется конечный байт null ('\0').

Функции strdupa() и strndupa() подобны предыдущим, но для выделения буфера используют alloca(3). Эти функции доступны только при использовании GNU GCC и имеют ограничения, описанные в alloca(3).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении функция strdup() возвращает указатель на копию строки. Она возвращает NULL, если недостаточно памяти и записывает в errno номер ошибки.

ОШИБКИ

Недостаточно памяти для размещения копии строки.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
strdup(), strndup(), strdupa(), strndupa() Безвредность в нитях MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ

Функция strdup() соответствует SVr4, 4.3BSD и POSIX.1-2001. strndup() соответствует POSIX.1-2008. strdupa() и strndupa() являются расширениями GNU.

СМ. ТАКЖЕ

alloca(3), calloc(3), free(3), malloc(3), realloc(3), string(3), wcsdup(3)

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу 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.

6 марта 2019 г. GNU