std::strcspn

 

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>
std::size_t strcspn(constchar*dest, constchar*src );

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

Имя функции означает "complementary span - дополнительный диапазон".

Параметры

dest	—	указатель на строку байтов с нулевым завершающим символом, подлежащую анализу
src	—	указатель на строку байтов с нулевым завершающим символом, содержащую искомые символы

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

Длина максимального начального сегмента, содержащего только символы, не найденные в строке байтов, на которую указывает src.

Пример

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

#include <cstddef>#include <cstring>#include <iomanip>#include <iostream>#include <string>   int main(){std::string s ="abcde312$#@";constchar* invalid ="*$#";   conststd::size_t valid_len = std::strcspn(s.c_str(), invalid);if(valid_len != s.size()){std::cout<<std::quoted(s)<<" содержит недопустимые символы, начиная с позиции "<< valid_len <<'\n'<<std::string(valid_len +1, '-')<<"^\n";}}

Вывод:

"abcde312$#@" содержит недопустимые символы, начиная с позиции 8 ---------^

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

strspn	возвращает длину максимального начального сегмента, который состоит только из символов, найденных в другой строке байтов (функция)
wcscspn	возвращает длину максимального начального сегмента, который состоит только из широких символов не найденных в другой широкой строке (функция)
strpbrk	находит первое местоположение любого символа из набора разделителей (функция)
find_first_of	ищет первое вхождение символов (public функция-элемент std::basic_string<CharT,Traits,Allocator>)
Документация C по strcspn