Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



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

strsep(3) извлечение токена из строки


ОБЗОР

#include <string.h>


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

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

strsep(): _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 и поэтому более переносима.

ДЕФЕКТЫ

Используйте данную функцию с осторожностью. Учитывайте, что:
  • Данная функция изменяет первый аргумент.
  • Эта функция не может использоваться со строками-константами.
  • Теряется идентичность символа-разделителя.