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 не является нулевым указателем, этот вызов является первым вызовом в последовательности. Цель поиска — строка байтов, завершающаяся нулём, на которую указывает str.
• Если str является нулевым указателем, этот вызов является одним из последующих вызовов в последовательности. Цель поиска определяется предыдущим вызовом в последовательности.

• Если такой символ не найден, в цели поиска нет токенов. Цель поиска для следующего вызова в последовательности не изменяется.^[1]
• Если такой символ найден, он является началом текущего токена. strtok затем ищет, начиная с этой позиции, первый символ, который содержится в строке-разделителе.
  • Если такой символ не найден, текущий токен продолжается до конца цели поиска. Цель поиска для следующего вызова в последовательности — пустая строка.^[2]
  • Если такой символ найден, он заменяется нулевым символом, который завершает текущий токен. Цель поиска для следующего вызова в последовательности начинается со следующего символа.

• При каждом вызове записывает в *strmax количество символов, оставшихся для просмотра в str, и записывает внутреннее состояние токенизатора в *ptr.
• В последующих вызовах последовательности необходимо передавать strmax и ptr со значениями, сохранёнными предыдущим вызовом.
• Следующие ошибки обнаруживаются во время выполнения и приводят к вызову текущей установленной функции обработчика ограничений; при этом ничего не сохраняется в объекте, на который указывает ptr:
  • strmax, delim или ptr является нулевым указателем.
  • *ptr является нулевым указателем при последующем вызове в последовательности.
  • *strmax больше, чем RSIZE_MAX.
  • Конец найденного токена не находится в пределах первых *s1max символов цели поиска.

Параметры

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

Примечание

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

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

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

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

Пример

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

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.24.5.8 Функция strtok (стр. TBD)
• K.3.7.3.1 Функция strtok_s (стр. TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.24.5.8 Функция strtok (стр. TBD)
• K.3.7.3.1 Функция strtok_s (стр. TBD)
• Стандарт 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

См. также