std::basic_string<CharT,Traits,Allocator>::find_first_not_of

size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const;	(1)	(noexcept с C++11) (constexpr с C++20)
size_type find_first_not_of( const CharT* s, size_type pos, size_type count ) const;	(2)	(constexpr с C++20)
size_type find_first_not_of( const CharT* s, size_type pos = 0 ) const;	(3)	(constexpr с C++20)
size_type find_first_not_of( CharT ch, size_type pos = 0 ) const;	(4)	(noexcept с C++11) (constexpr с C++20)
template< class StringViewLike > size_type find_first_not_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* see below */);	(5)	(с C++17) (constexpr с C++20)

Находит первый символ, не совпадающий ни с одним из символов заданной последовательности символов. При поиске рассматривается только диапазон [pos, size()). Если все символы диапазона найдены в заданной последовательности символов, возвращается npos.

1) Находит первый символ, не совпадающий ни с одним из символов в str.

2) Находит первый символ, не совпадающий ни с одним из символов диапазона [s, s + count). Этот диапазон может содержать нулевые символы.

Если [s, s + count) не является допустимым диапазоном, поведение не определено.

3) Находит первый символ, не совпадающий ни с одним из символов строки, на которую указывает s. Длина строки определяется по первому нулевому символу с помощью Traits::length(s).

Если [s, s + Traits::length(s)) не является допустимым диапазоном, поведение не определено.

4) Находит первый символ, не равный ch.

5) Неявно преобразует t в string view sv, как если бы применялся std::basic_string_view<CharT, Traits> sv = t;, а затем находит первый символ, не совпадающий ни с одним из символов в sv.

Эта перегрузка участвует в разрешении перегрузки только в том случае, если std::is_convertible_v<const StringViewLike&,std::basic_string_view<CharT, Traits>> — это true, а std::is_convertible_v<const StringViewLike&, const CharT*> — это false.

Во всех случаях равенство проверяется вызовом Traits::eq.

Параметры

str	-	строка, задающая символы для поиска
pos	-	позиция, с которой начинается поиск
count	-	длина строки, задающей символы для поиска
s	-	указатель на строку символов, задающую символы для поиска
ch	-	символ, задающий символы для поиска
t	-	объект (преобразуемый в `std::basic_string_view`), задающий символы для поиска

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

Позиция найденного символа или std::string::npos, если такой символ не найден.

Исключения

1,4) Ничего не выбрасывает.

noexcept спецификация:

noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)

Если по какой-либо причине выбрасывается исключение, эта функция не оказывает никакого эффекта (строгая гарантия безопасности при исключениях).

Пример

#include <iostream>
#include <string>

int main()
{
    // Permit uppercase letters, lowercase letters and numbers in macro names
    const char* pattern = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
                          "abcdefghijklmnopqrstuvwxyz"
                          "0123456789";

    std::string data = "1) %FIX, 2) %HACK, and 3) %TODO";
    const std::string replacement = "%DONE%";

    std::cout << "Before: " << data << '\n';

    for (std::string::size_type first{}, last{};
        (first = data.find('%', first)) != std::string::npos;
        first += replacement.size())
    {
        last = data.find_first_not_of(pattern, first + 1);
        if (last == std::string::npos)
            last = data.length();

        // Now first at '%' and last is one past end of the found substring
        data.replace(first, last - first, replacement);
    }

    std::cout << "After: " << data << '\n';
}

Вывод:

Before: 1) %FIX, 2) %HACK, and 3) %TODO
After: 1) %DONE%, 2) %DONE%, and 3) %DONE%

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

DR	Применяется к	Опубликованное поведение	Корректное поведение
LWG 847	C++98	гарантия безопасности при исключениях отсутствовала	добавлена строгая гарантия безопасности при исключениях
LWG 2064	C++11	перегрузки (3,4) имели спецификацию noexcept	удалено
LWG 2946	C++17	перегрузка (5) в некоторых случаях приводила к неоднозначности	проблема устранена путём превращения её в шаблон
P1148R0	C++11 C++17	noexcept для перегрузок (4,5) был случайно удалён в результате LWG2064/LWG2946	восстановлен

См. также

find	находит первое вхождение заданной подстроки (открытая функция-член)
rfind	находит последнее вхождение подстроки (открытая функция-член)
find_first_of	находит первое вхождение символов (открытая функция-член)
find_last_of	находит последнее вхождение символов (открытая функция-член)
find_last_not_of	находит последнее отсутствие символов (открытая функция-член)
find_first_not_of	находит первое отсутствие символов (открытая функция-член `std::basic_string_view<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string/find_first_not_of