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 и поэтому более переносима.
ДЕФЕКТЫ
Используйте данную функцию с осторожностью. Учитывайте, что:
Данная функция изменяет первый аргумент.
Эта функция не может использоваться со строками-константами.
Теряется идентичность символа-разделителя.