strtok_s, , _strtok_s_l_wcstok_s_lwcstok_s_mbstok_s,_mbstok_s_l

Находит следующий токен в строке с использованием текущего или переданного языкового стандарта. Эти версии , , _strtok_l, _mbstok_lwcstok_wcstok_l_mbstok имеют улучшения безопасности, как описано в функциях strtokбезопасности в CRT.

Синтаксис

char* strtok_s(
   char* str,
   const char* delimiters,
   char** context
);

char* _strtok_s_l(
   char* str,
   const char* delimiters,
   char** context,
   _locale_t locale
);

wchar_t* wcstok_s(
   wchar_t* str,
   const wchar_t* delimiters,
   wchar_t** context
);

wchar_t *_wcstok_s_l(
   wchar_t* str,
   const wchar_t* delimiters,
   wchar_t** context,
   _locale_t locale
);

unsigned char* _mbstok_s(
   unsigned char* str,
   const unsigned char* delimiters,
   char** context
);

unsigned char* _mbstok_s_l(
   unsigned char* str,
   const unsigned char* delimiters,
   char** context,
   _locale_t locale
);

Параметры

str
Строка, содержащая маркер или маркеры для поиска.

delimiters
Набор символов разделителя, используемых.

context
Используется для хранения сведений о позиции между вызовами функции.

locale
Используемый языковой стандарт.

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

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

Условия ошибок

Если str это NULL указатель context на допустимый указатель контекста, ошибка отсутствует.

Замечания

Семейство strtok_s функций находит следующий маркер в str. Набор символов в параметре delimiters указывает возможные разделители токенов, которые требуется найти в str во время текущего вызова. Функции wcstok_s и _mbstok_s являются версиями функции strtok_s для расширенных и многобайтовых символов. Аргументы и возвращаемые значения wcstok_s _wcstok_s_l и являются строками с широкими символами. Аргументы и возвращаемые значения _mbstok_s _mbstok_s_l и являются многобайтовыми строками. В остальном эти функции ведут себя одинаково.

Эта функция проверяет свои параметры. При возникновении условия ошибки, как в таблице "Условия ошибки", вызывается обработчик недопустимых параметров, как описано в разделе "Проверка параметров". Если выполнение может быть продолжено, эти функции устанавливают параметр errno в значение EINVAL и возвращают значение NULL.

При первом вызове функции strtok_s она пропускает ведущие разделители и возвращает указатель на первый токен в str, завершая токен нуль-символом. Из оставшейся части str можно выделить другие токены с помощью последовательных вызовов функции strtok_s. Каждый вызов функции strtok_s изменяет str, вставляя нуль-символ после токена, возвращенного этим вызовом. Указатель context продолжает отслеживать читаемую строку и место в строке, из которого следует считать следующий токен. Чтобы прочитать следующий токен из str, вызовите функцию strtok_s со значением NULL для аргумента str и передайте тот же параметр context. Аргумент NULL str вызывает strtok_s поиск следующего маркера в измененном str. Аргумент delimiters в разных вызовах может принимать любое значение, позволяя изменять набор разделителей.

context Так как параметр заменяет статические буферы, используемые вstrtok, и _strtok_lпозволяет анализировать две строки одновременно в одном потоке.

Выходное значение зависит от параметра LC_CTYPE категории языкового стандарта. Дополнительные сведения см. в разделе setlocale.

Версии этих функций без _l суффикса используют текущий языковой стандарт потока для этого поведения, зависяющего от языкового стандарта. Версии с суффиксом _l идентичны, за исключением того, что они используют языковой стандарт, указанный параметром locale . Дополнительные сведения см. в разделе Locale.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Требования

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_strtok_s.c
// In this program, a loop uses strtok_s
// to print all the tokens (separated by commas
// or blanks) in two strings at the same time.

#include <string.h>
#include <stdio.h>

char string1[] =
    "A string\tof ,,tokens\nand some  more tokens";
char string2[] =
    "Another string\n\tparsed at the same time.";
char seps[]   = " ,\t\n";
char *token1 = NULL;
char *token2 = NULL;
char *next_token1 = NULL;
char *next_token2 = NULL;

int main(void)
{
    printf("Tokens:\n");

    // Establish string and get the first token:
    token1 = strtok_s(string1, seps, &next_token1);
    token2 = strtok_s(string2, seps, &next_token2);

    // While there are tokens in "string1" or "string2"
    while ((token1 != NULL) || (token2 != NULL))
    {
        // Get next token:
        if (token1 != NULL)
        {
            printf(" %s\n", token1);
            token1 = strtok_s(NULL, seps, &next_token1);
        }
        if (token2 != NULL)
        {
            printf("        %s\n", token2);
            token2 = strtok_s(NULL, seps, &next_token2);
        }
    }
}

Tokens:
A
        Another
string
        string
of
        parsed
tokens
        at
and
        the
some
        same
more
        time.
tokens

См. также

Обработка строк
Локаль
Интерпретация последовательностей многобайтовых символов
strcspn, , wcscspn_mbscspn_mbscspn_l
strspn, , wcsspn_mbsspn_mbsspn_l