strtok, strtok_s

Токенизирует нуль-терминированную байтовую строку.

1. ↑ Токен может быть сформирован при последующем вызове с другой строкой-разделителем.
2. ↑ При последующих вызовах больше не может быть сформировано токенов.

Параметры

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

Примечание

Эта функция является деструктивной: она записывает ' \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 <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'

Ссылки

Смотрите также