STRSEP(3)

ИМЯ
strsep - извлечение токена из строки

ОБЗОР
#include <string.h>

char *strsep(char **stringp, const char *delim);

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

strsep():
    Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 и старее:
        _BSD_SOURCE

ОПИСАНИЕ
Если значение *stringp равно NULL, то функция strsep() возвращает NULL и ничего не делает. В противном случае она ищет первый токен в строке *stringp, который отделён в строке одним байтом из delim. Этот токен завершается символом null ('\0'), который устанавливается на место символа разделителя, а значению *stringp присваивается значение, указывающее на следующий символ после токена. Если разделитель не найден, то токеном считается вся строка *stringp и значению *stringp присваивается NULL.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция strsep() возвращает указатель на токен, то есть возвращает исходное значение *stringp.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
strsep() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
4.4BSD.

ЗАМЕЧАНИЯ
Функция strsep() была введена в качестве замены функции strtok(3), потому что последняя не может обрабатывать пустые поля. Тем не менее, функция strtok(3) соответствует C89/C99 и поэтому более переносима.

ДЕФЕКТЫ
Используйте данную функцию с осторожностью. Учитывайте, что:

*   Данная функция изменяет первый аргумент.

*   Эта функция не может использоваться со строками-константами.

*   Теряется идентичность символа-разделителя.

СМОТРИТЕ ТАКЖЕ
index(3), memchr(3), rindex(3), strchr(3), string(3), strpbrk(3), strspn(3), strstr(3), strtok(3)