std::basic_string<CharT,Traits,Allocator>::find_last_not_of
Материал из cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| (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(/* смотрите ниже */); |
(начиная с C++17) (до C++20) |
|
template< class StringViewLike > constexpr size_type find_last_not_of( const StringViewLike& t, size_type pos = npos ) const noexcept(/* смотрите ниже */); |
(начиная с C++20) | |
Находит последний символ, не равный ни одному из символов в заданной последовательности символов. При поиске учитывается только диапазон [0, pos]. Если все символы диапазона можно найти в заданной последовательности символов, будет возвращено npos.
1) Находит последний символ, не равный ни одному из символов в
str.2) Находит последний символ, не равный ни одному из символов в диапазоне
[s, s + count). Этот диапазон может включать нулевые символы.3) Находит последний символ, не равный ни одному из символов в строке ��имволов, на которую указывает
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) Ничего не генерирует.
5)
спецификация 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 << "не найдено\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', '\0'};
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)); // не найдено
}
Вывод:
[3] = '_'
[2] = 'c'
[1] = 'b'
[5] = '2'
[2] = 'c'
[6] = '3'
не найдено
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| 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) в некоторых случаях вызывала двусмысленность |
исправлено, сделав её шаблоном |
| WG не указан | C++11 C++17 |
noexcept перегрузок (4,5) были случайно удалены LWG2064/LWG2946 |
восстановлены |
Смотрите также
| находит первое вхождение заданной подстроки (public функция-элемент) | |
| ищет последнее вхождение подстроки (public функция-элемент) | |
| ищет первое вхождение символов (public функция-элемент) | |
| ищет первое отсутствие символов (public функция-элемент) | |
| ищет последнее вхождение символов (public функция-элемент) | |
(C++17) |
ищет последнее отсутствие символов (public функция-элемент std::basic_string_view<CharT,Traits>)
|