STRSEP - Linux手册页

时间:2019-08-20 18:01:25  来源:igfitidea点击:

Linux程序员手册 第3部分
更新日期: 2019-03-06

名称

strsep-从字符串中提取令牌

语法

#include <string.h>

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

glibc的功能测试宏要求(请参阅feature_test_macros(7)):

strsep():
从glibc 2.19开始:
_DEFAULT_SOURCE
Glibc 2.19及更早版本:
_BSD_SOURCE

说明

如果* stringp为NULL,则strsep()函数将返回NULL,并且不执行其他任何操作。否则,此函数将在字符串* stringp中找到第一个标记,该标记由字符串delim中的一个字节定界。通过用空字节(aq \ 0aq)覆盖定界符来终止此令牌,并且* stringp更新为指向该令牌之后。如果未找到定界符,则将令牌视为整个字符串* stringp,并将* stringp设为NULL。

返回值

strsep()函数返回指向令牌的指针,即,它返回* stringp的原始值。

属性

有关本节中使用的术语的说明,请参见attribute(7)。

InterfaceAttributeValue
strsep()Thread safetyMT-Safe

遵循规范

4.4BSD。

备注

引入了strsep()函数来替代strtok(3),因为后者无法处理空字段。但是,strtok(3)符合C89 / C99,因此更便于携带。

BUGS

使用此功能时要小心。如果确实使用它,请注意:

*
该函数修改其第一个参数。
*
此函数不能在常量字符串上使用。
*
分隔字符的标识丢失。

另外参见

index(3),memchr(3),rindex(3),strchr(3),string(3),strpbrk(3),strspn(3),strstr(3),strtok(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本,请访问https://www.kernel.org/doc/man-pages/