strtok, strtok_s

对以空字符结尾的字节字符串进行分词处理。

1. ↑ 在后续使用不同分隔字符串的调用中仍可能形成标记。
2. ↑ 后续调用中无法再形成更多标记。

参数

返回值

注意

此函数具有破坏性：它会在字符串 str 的元素中写入 ' \0 ' 字符。特别需要注意的是，字符串字面量不能作为 strtok 的第一个参数使用。

每次调用 strtok 都会修改静态变量：不具备线程安全性。

与大多数其他分词器不同， strtok 中的分隔符对于每个后续标记可以各不相同，甚至可以依赖于先前标记的内容。

strtok_s 函数与 POSIX strtok_r 函数的区别在于：前者能防止在待分割字符串外部存储数据，并会检查运行时约束。Microsoft CRT 的 strtok_s 函数签名符合此 POSIX strtok_r 定义，而非 C11 标准的 strtok_s 。

示例

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <string.h>
int main(void)
{
    char input[] = "A bird came down the walk";
    printf("Parsing the input string '%s'\n", input);
    char* token = strtok(input, " ");
    while (token)
    {
        puts(token);
        token = strtok(NULL, " ");
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input; ++n)
        input[n] ? putchar(input[n]) : fputs("\\0", stdout);
    puts("'");
#ifdef __STDC_LIB_EXT1__
    char str[] = "A bird came down the walk";
    rsize_t strmax = sizeof str;
    const char* delim = " ";
    char* next_token;
    printf("Parsing the input string '%s'\n", str);
    token = strtok_s(str, &strmax, delim, &next_token);
    while (token)
    {
        puts(token);
        token = strtok_s(NULL, &strmax, delim, &next_token);
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof str; ++n)
        str[n] ? putchar(str[n]) : fputs("\\0", stdout);
    puts("'");
#endif
}

Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'
Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'

参考文献

参阅