strtok_s

1）在由str指向的以空字符结尾的字节字符串中查找下一个标记。 分隔符字符由delim指向的以空字符结尾的字节字符串标识。

该函数被设计为被称为倍数时间以从相同的字符串获得连续的令牌。

• 如果str！= NULL，则该调用被视为针对此特定字符串的第一次调用strtok。该函数搜索不在delim中的第一个字符。
• 如果没有找到这样的字符，那么str中就没有令牌了，并且该函数返回一个空指针。
• 如果找到这样的字符，它就是令牌的开始。然后该函数从此处开始搜索包含在delim中的第一个字符。

如果没有找到这样的字符，str只有一个标记，未来对strtok的调用将返回一个空指针

如果找到这样的字符，它将被替换为空字符'\ 0'，并且指向以下字符的指针将存储在静态位置以供后续调用。

• 该函数然后将指针返回到令牌的开始处
• 如果str == NULL，则该调用将被视为对strtok的后续调用：该函数将继续前一次调用中的离开。行为与先前存储的指针作为str传递的行为相同。

如果str或delim不是指向以空字符结尾的字节字符串的指针，则行为未定义。

2）与（1）相同，除了在每一步中，将留在str中的字符数写入* strmax并将标记器的内部状态写入* ptr。 重复调用（使用null str）必须将strmax和ptr与先前调用所存储的值一起传递。 此外，在运行时检测到以下错误，并调用当前安装的约束处理函数，而不在ptr指向的对象中存储任何内容

• strmax，delim或者ptr是空指针
• 在非初始调用（带有空值str）上，*ptr是一个空指针
• 在第一次通话时，*strmax是零或大于RSIZE_MAX
• 搜索令牌的末尾到达源字符串的末尾（如初始值所测量的那样*strmax）），而不会遇到空终止符

如果两个str都指向缺少空字符的字符数组，并且strmax指向的值大于该字符数组的大小，则行为是未定义的。 作为所有边界检查函数，只有当__STDC_LIB_EXT1__由实现定义并且用户在包含string.h之前将__STDC_WANT_LIB_EXT1__定义为整数常量1时，strtok_s才能保证可用。

参数

返回值

返回指向下一个标记开头的指针，如果没有其他标记，则返回NULL。

注意

这个函数具有破坏性：它在字符串str的元素中写入'\ 0'字符。 特别是，字符串文字不能用作strtok的第一个参数。

每次调用strtok都会修改一个静态变量：不是线程安全的。

与大多数其他标记器不同，strtok中的分隔符对于每个后续标记都可能不同，甚至可能取决于先前标记的内容。

该strtok_s函数不同于POSIX strtok_r函数，通过防止存储在被标记化的字符串之外，并通过检查运行时约束。

例

#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h>
#include <stdio.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] ? printf("%c", input[n]) : printf("\\0");
    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] ? printf("%c", str[n]) : printf("\\0");
    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'

参考

• C11标准（ISO / IEC 9899：2011）：
  • 7.24.5.8 strtok函数（p：369-370）
  • K.3.7.3.1 strtok_s函数（p：620-621）
• C99标准（ISO / IEC 9899：1999）：
  • 7.21.5.8 strtok函数（p：332-333）
• C89 / C90标准（ISO / IEC 9899：1990）：
  • 4.11.5.8 strtok函数

扩展内容

| 用于strtok 的C ++文档|