table of contents
STRSEP(3) | Руководство программиста Linux | STRSEP(3) |
ИМЯ¶
strsep - извлечение токена из строки
ОБЗОР¶
#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.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
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)
2011-09-28 | GNU |