Namespaces
Variants

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

Из ru.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(/* 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 в строковое представление 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> )