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.

Параметры

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

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

Примечание

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

В отличие от strtok, wcstok не обновляет статическое хранилище: она сохраняет состояние анализатора в предоставленном пользователем месте.

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

Реализация wcstok_s в Windows CRT несовместима со стандартом 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'

Ссылки

Смотри также