strtok, strtok_s

ヌル終端バイト文字列をトークン化します。

1. ↑ 異なる区切り文字列を用いた後続の呼び出しでトークンが形成される可能性があります。
2. ↑ 後続の呼び出しではこれ以上トークンを形成できません。

パラメータ

戻り値

注記

この関数は破壊的です：文字列 str の要素に ' \0 ' 文字を書き込みます。特に、文字列リテラルは strtok の第一引数として使用できません。

strtok への各呼び出しは静的変数を変更します：スレッドセーフではありません。

他のほとんどのトークナイザとは異なり、 strtok の区切り文字は、後続の各トークンごとに異なる場合があり、前のトークンの内容に依存することさえあります。

strtok_s 関数は、POSIXの strtok_r 関数とは、トークン化対象の文字列外への保存を防止し、ランタイム制約をチェックする点で異なります。Microsoft CRTの strtok_s シグネチャは、C11の strtok_s ではなく、このPOSIXの strtok_r 定義に一致します。

例

#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'

参考文献

関連項目