std::basic_string<CharT,Traits,Allocator>::find_last_not_of
| (1) | ||
size_type find_last_not_of( const basic_string& str,
size_type pos = npos ) const; | (до C++11) | |
size_type find_last_not_of( const basic_string& str,
size_type pos = npos ) const noexcept;
| (с C++11) (до C++20) | |
constexpr size_type find_last_not_of( const basic_string& str,
size_type pos = npos ) const noexcept;
| (с C++20) | |
| (2) | ||
size_type find_last_not_of( const CharT* s,
size_type pos, size_type count ) const; | (до C++20) | |
constexpr size_type find_last_not_of( const CharT* s,
size_type pos, size_type count ) const;
| (с C++20) | |
| (3) | ||
size_type find_last_not_of( const CharT* s, size_type pos = npos ) const; | (до C++20) | |
constexpr size_type find_last_not_of( const CharT* s,
size_type pos = npos ) const;
| (с C++20) | |
| (4) | ||
size_type find_last_not_of( CharT ch, size_type pos = npos ) const; | (до C++11) | |
size_type find_last_not_of( CharT ch, size_type pos = npos ) const noexcept; | (с C++11) (до C++20) | |
constexpr size_type find_last_not_of( CharT ch,
size_type pos = npos ) const noexcept;
| (с C++20) | |
| (5) | ||
template< class StringViewLike >
size_type
find_last_not_of( const StringViewLike& t,
size_type pos = npos ) const noexcept(/* see below */); |
(с C++17) (до C++20) | |
template< class StringViewLike >
constexpr size_type
find_last_not_of( const StringViewLike& t,
size_type pos = npos ) const noexcept(/* see below */);
| (с C++20) |
Находит последний символ, не равный ни одному из символов в заданной последовательности символов. Поиск учитывает только диапазон [0, pos]. Если все символы в диапазоне присутствуют в заданной последовательности символов, то возвращается npos.
str. [s, s + count). Этот диапазон может включать нулевые символы.s. Длина строки определяется первым нулевым символом с помощью Traits::length(s).ch.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 если такой символ не найден.
Исключения
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 | восстановлены |
См. также
| находит первое вхождение заданной подстроки (общедоступный член-функция) |
|
| находит последнее вхождение подстроки (общедоступный член-функция) |
|
| находит первое вхождение символов (общедоступный член-функция) |
|
| находит первое отсутствие символов (общедоступный член-функция) |
|
| находит последнее вхождение символов (общедоступный член-функция) |
|
| находит последнее отсутствие символов (общедоступный член-функция std::basic_string_view<CharT,Traits>) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/find_last_not_of