Namespaces
Variants

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

From cppreference.net
std::basic_string
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 ( /* см. ниже */ ) ;
(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 в строковое представление 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) Ничего не выбрасывает.
5)
noexcept спецификация:
noexcept ( std:: is_nothrow_convertible_v < const T & , std:: basic_string_view < CharT, Traits >> )

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

Пример

#include <iostream>
#include <string>
int main()
{
    // Разрешить прописные буквы, строчные буквы и цифры в именах макросов
    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();
        // Теперь first на '%' и last на один символ после конца найденной подстроки
        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 Applied to Behavior as published Correct behavior
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
восстановлены

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

находит первое вхождение заданной подстроки
(публичная функция-член)
находит последнее вхождение подстроки
(публичная функция-член)
находит первое вхождение символов
(публичная функция-член)
находит последнее вхождение символов
(публичная функция-член)
находит последнее отсутствие символов
(публичная функция-член)
находит первое отсутствие символов
(публичная функция-член std::basic_string_view<CharT,Traits> )