wcstok, wcstok_s

• 若 str != NULL ，则调用被当做 wcstok 首次对此具体宽字符的调用。函数搜索首个不含于 delim 的字符。

• 若找不到这种宽字符，则 str 中完全无记号，而函数返回空指针。
• 若找到这种宽字符，则它是记号起始。然后函数从该点搜索首个含于 delim 的宽字符。

• 若找不到这种宽字符，则 str 只有一个记号，而对 wcstok 的将来调用将返回空指针
• 若找到这种宽字符，则以空宽字符 L'\0' 替换它，并存储分析状态（典型地为指向后一宽字符的指针）于用户提供位置 *ptr 。

• 然后函数返回指向记号起始的指针

• 若 str == NULL ，则调用被当作对 wcstok 的后继调用：函数从带同一 *ptr 的先前调用所留下的位置开始持续。行为与如同将指向后随上次检测的记号的宽字符的指针作为 str 传递相同。

参数

返回值

返回指向下个记号起始的指针，或若无更多记号则为空指针。

注意

此函数是破坏性的：它写入 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'

引用