strtok, strtok_s

char *strtok( char *str, const char *delim );

char *strtok( char *restrict str, const char *restrict delim );

char *strtok_s(char *restrict str, rsize_t *restrict strmax,
     const char *restrict delim, char **restrict ptr);

• Если str не является указателем на NULL, вызов обрабатывается как первый вызов strtok для данной строки. Функция ищет первый символ, который не содержится в delim.
• Если такой символ не был найден, то в str вообще нет токенов, и функция возвращает нулевой указатель.
• Если такой символ был найден, он является началом токена. Затем функция ищет от этой точки первый символ, который содержится в delim.
• Если такой символ не был найден, str содержит только один токен, и последующие вызовы strtok будут возвращать нулевой указатель.
• Если такой символ был найден, он заменяется нулевым символом '\0', и указатель на следующий символ сохраняется в статическом месте для последующих вызовов.
• Затем функция возвращает указатель на начало токена.
• Если str является нулевым указателем, вызов обрабатывается как последующий вызов strtok: функция продолжает с того места, где остановилась в предыдущем вызове. Поведение такое же, как если бы ранее сохраненный указатель был передан как str.

Параметры

Возвращаемое значение

Возвращает указатель на начало следующего токена или нулевой указатель, если больше нет токенов.

Примечание

Эта функция является деструктивной: она записывает '\0' символов в элементы строки str. В частности, строковая константа не может использоваться в качестве первого аргумента strtok.

Каждый вызов strtok изменяет статическую переменную: не является потокобезопасной.

В отличие от большинства других токенизаторов, разделители в strtok могут отличаться для каждого последующего токена и даже могут зависеть от содержимого предыдущих токенов.

Функция strtok_s отличается от функции POSIX strtok_r тем, что она защищает от хранения за пределами токенизируемой строки и проверяет ограничения во время выполнения. Подпись Microsoft CRT strtok_s соответствует этому определению POSIX strtok_r, а не C11 strtok_s.

Пример

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

Ссылки

• Стандарт C11 (ISO/IEC 9899:2011):
• 7.24.5.8 Функция strtok (с. 369-370)
• K.3.7.3.1 Функция strtok_s (с. 620-621)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.21.5.8 Функция strtok (с. 332-333)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.11.5.8 Функция strtok

См. также