wcstok, wcstok_s

wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t** ptr );

wchar_t* wcstok( wchar_t*  restrict str, const wchar_t* restrict delim,
                 wchar_t** restrict ptr );

wchar_t* wcstok_s( wchar_t* restrict str, rsize_t* restrict strmax,
                   const wchar_t* restrict delim, wchar_t** restrict ptr);

• 如果 str != NULL，则该调用被视为对此特定宽字符串的首次调用 wcstok。函数搜索第一个 不 包含在 delim 中的宽字符。

• 如果未找到这样的宽字符，则 str 中根本就没有记号，函数返回空指针。
• 如果找到了这样的宽字符，则它是记号的 开始。然后函数从该位置开始搜索第一个 包含 在 delim 中的宽字符。

• 如果没有找到这样的宽字符，则 str 只有一个记号，之后对 wcstok 的调用将返回空指针。
• 如果找到了这样的宽字符，则将其 替换 为空宽字符 L'\0'，并将解析器状态（通常是指向后续宽字符的指针）存储在用户提供的位置 *ptr。

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

• 如果 str == NULL，则调用被视为对 wcstok 的后续调用：函数从上一次对同一个 *ptr 调用时离开的位置继续。行为等同于将指向最后一个检测到的记号之后的宽字符的指针作为 str 传入。

参数

返回值

返回指向下一个令牌起始位置的指针，若无更多令牌则返回空指针。

注释

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

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

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

Windows CRT 中的 wcstok_s 实现与 C 标准不兼容，它仅仅是 wcstok 的别名。

示例

#include <stdio.h>
#include <wchar.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'

参考文献

参阅