std::strtok

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

Однобайтовые строки с завершающим нулём

Функции
Манипуляции с символами
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
Преобразование в числовые форматы
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
Манипуляции со строками
strcpy strncpy strxfrm	strcat strncat
Проверка строки
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Манипуляции с памятью
memchr memcmp memset	memcpy memmove
Разное
strerror

 

Определено в заголовочном файле <cstring>
char* strtok(char* str, constchar* delim );

Находит следующий токен в строке байтов с нулевым завершающим символом, на которую указывает str. Символы-разделители идентифицируются строкой байтов с нулевым завершающим символом, на которую указывает delim.

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

• Если str не является нулевым указателем, вызов рассматривается как первый вызов strtok для этой конкретной строки. Функция ищет первый символ, который не содержится в delim.

• Если такой символ не найден, то в str вообще нет токенов и функция возвращает нулевой указатель.
• Если такой символ был найден, это начало токена. Затем функция с этого места ищет первый символ, который содержится в delim.

• Если такой символ не найден, str имеет только один токен, и будущие вызовы strtok вернут нулевой указатель.
• Если такой символ был найден, он заменяется нулевым символом '\0', а указатель на следующий символ сохраняется в статическом расположении для последующих вызовов.

• Затем функция возвращает указатель на начало токена.

• Если str является нулевым указателем, вызов рассматривается как последующий вызов strtok: функция продолжает работу с того места, где она остановилась при предыдущем вызове. Поведение такое же, как если бы ранее сохранённый указатель был передан как str.

Параметр

str	—	указатель на строку байтов с нулевым завершающим символом для токенизации
delim	—	указатель на строку байтов с нулевым завершающим символом, определяющую разделители

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

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

Примечание

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

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

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

Возможная реализация

char* strtok(char* str, constchar* delim){staticchar* buffer;   if(str != nullptr) buffer = str;   buffer +=std::strspn(buffer, delim);   if(*buffer =='\0')return nullptr;   char*const tokenBegin = buffer;   buffer +=std::strcspn(buffer, delim);   if(*buffer !='\0')*buffer++='\0';   return tokenBegin;}

Фактические реализации этой функции в библиотеке C++ делегируются библиотеке C, где она может быть реализована напрямую (как в MUSL libc), или в виде реентерабельной версии (как в GNU libc).

Пример

Запустить этот код

#include <cstring>#include <iomanip>#include <iostream>   int main(){char input[]="one + two * (three - four)!";constchar* delimiters ="! +- (*)";char*token = std::strtok(input, delimiters);while(token){std::cout<<std::quoted(token)<<' '; token = std::strtok(nullptr, delimiters);}   std::cout<<"\nСодержимое входной строки сейчас:\n\"";for(std::size_t n =0; n < sizeof input;++n){if(constchar c = input[n]; c !='\0')std::cout<< c;elsestd::cout<<"\\0";}std::cout<<"\"\n";}

Вывод:

"one" "two" "three" "four" Содержимое входной строки сейчас: "one\0+ two\0* (three\0- four\0!\0"

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

strpbrk	находит первое местоположение любого символа из набора разделителей (функция)
strcspn	возвращает длину максимального начального сегмента, который состоит только из символов, не найденных в другой строке байтов (функция)
strspn	возвращает длину максимального начального сегмента, который состоит только из символов, найденных в другой строке байтов (функция)
ranges::split_viewviews::split (C++20)	view по поддиапазонам, полученным в результате разделения другого view с использованием разделителя (шаблон класса)(объект адаптера диапазона)
Документация C по strtok