Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   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.