wcstok_s

wcstok, wcstok_s

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

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

• 如果str != NULL该呼叫被视为wcstok该特定宽字符串的第一个呼叫。该函数搜索不包含在其中的第一个宽字符delim。

2）同（1），所不同的是在每一个步骤中，写入的字符数向左看在str成*strmax。重复呼叫（使用null str）必须通过strmax，并ptr与以前调用存储的值。此外，在运行时检测到以下错误，并调用当前安装的约束处理函数，而不在指向的对象中存储任何内容ptr

• strmax，delim或者ptr是空指针

作为所有边界检查函数，wcstok_s只有在被__STDC_LIB_EXT1__实现定义__STDC_WANT_LIB_EXT1__并且1在包含之前用户定义为整数常量时才能保证可用wchar.h。

参数

返回值

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

注意

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

与其不同strtok，wcstok不更新静态存储：它将分析器状态存储在用户提供的位置。

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

示例

​

#include <wchar.h>
#include <stdio.h>
 
int main(void)
{
    wchar_t input[] = L"A bird came down the walk";
    printf("Parsing the input string '%ls'\n", input
    wchar_t *buffer;
    wchar_t *token = wcstok(input, L" ", &buffer
    while(token) {
        printf("%ls\n", token
        token = wcstok(NULL, L" ", &buffer
    }
 
    printf("Contents of the input string now: '"
    for(size_t n = 0; n < sizeof input / sizeof *input; ++n)
        input[n] ? printf("%lc", input[n]) : printf("\\0"
    puts("'"
}

​

输出：

​

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）：

另请参阅

| 用于wcstok |的C ++文档