strndup - дублирование строки
strndup(3)
дублирование строки
Other Alias
strdup, 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():
_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
|| /* начиная с glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
strndup():
Начиная с glibc 2.10:
_POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700
До 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 номер ошибки.
ОШИБКИ
ENOMEM
Недостаточно памяти для размещения копии строки.
АТРИБУТЫ
Описание терминов данного раздела смотрите в
attributes(7).
Интерфейс Атрибут Значение
strdup(),
strndup(),
strdupa(),
strndupa()
безвредность в потоках: безвредно (MT-Safe)
СООТВЕТСТВИЕ СТАНДАРТАМ
Функция
strdup() соответствует SVr4, 4.3BSD и POSIX.1-2001.
strndup()
соответствует POSIX.1-2008.
strdupa() и
strndupa() являются
расширениями GNU.
