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

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

Находит последний символ, не совпадающий ни с одним символом в заданной последовательности символов. Поиск выполняется только в диапазоне [0, pos]. Если все символы в диапазоне найдены в заданной последовательности символов, возвращается 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`), задающий символы для поиска

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

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

Исключения

1,4) Не выбрасывает исключений.

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

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

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

Пример

#include <iostream>
#include <string>

void show_pos(const std::string& str, std::string::size_type found)
{
    if (found != std::string::npos)
        std::cout << '[' << found << "] = \'" << str[found] << "\'\n";
    else
        std::cout << "not found\n";
}

int main()
{
    std::string str{"abc_123"};
    char const* skip_set{"0123456789"};
    std::string::size_type str_last_pos{std::string::npos};
    
    show_pos(str, str.find_last_not_of(skip_set)); // [3] = '_'
    
    str_last_pos = 2;
    show_pos(str, str.find_last_not_of(skip_set, str_last_pos)); // [2] = 'c'
    
    str_last_pos = 2;
    show_pos(str, str.find_last_not_of('c', str_last_pos)); // [1] = 'b'
    
    const char arr[]{'3', '4', '5'};
    show_pos(str, str.find_last_not_of(arr)); // [5] = '2'
    
    str_last_pos = 2;
    std::string::size_type skip_set_size{4};
    show_pos(str, str.find_last_not_of(skip_set,
                                       str_last_pos,
                                       skip_set_size)); // [2] = 'c'
    
    show_pos(str, str.find_last_not_of("abc")); // [6] = '3'
    
    str_last_pos = 2;
    show_pos(str, str.find_last_not_of("abc", str_last_pos)); // not found
}

Вывод:

[3] = '_'
[2] = 'c'
[1] = 'b'
[5] = '2'
[2] = 'c'
[6] = '3'
not found

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

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

DR	Применяется к	Опубликованное поведение	Корректное поведение
LWG 141	C++98	перегрузка (1) могла возвращать `npos` только если `pos >= size()`	в этом случае диапазон поиска `[0,` `size())`
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_first_not_of	находит первый символ, отсутствующий среди заданных (открытая функция-член)
find_last_of	находит последнее вхождение символов (открытая функция-член)
find_last_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_last_not_of