std::basic_string<CharT,Traits,Allocator>::rfind — cppreference.com
Материал из 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) | ||
|
|
(до C++11) | |
|
|
(начиная с C++11) (до C++20) |
|
|
|
(начиная с C++20) | |
| (2) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (3) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (4) | ||
|
|
(до C++11) | |
|
|
(начиная с C++11) (до C++20) |
|
|
|
(начиная с C++20) | |
| (5) | ||
|
|
(начиная с C++17) (до C++20) |
|
|
|
(начиная с C++20) | |
Находит последнюю подстроку, равную заданной последовательности символов. Поиск начинается с pos и продолжается справа налево (таким образом, найденная подстрока, если таковая имеется, не может начинаться с позиции, следующей за pos). Если npos или любое значение не меньшее size()- 1 передаётся как pos, поиск будет осуществляться по всей строке.
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, если такая подстрока не найдена. Обратите внимание, что это смещение от начала строки, а не от конца.
Если осуществляется поиск пустой строки (т.е. str.size(), count или Traits::length(s) равны нулю), пустая строка находится немедленно, и rfind возвращает:
pos, еслиpos < size();size()иначе, включая случай, когдаpos == npos.
Иначе, если size() равно нулю, всегда возвращается npos.
Исключения
1,4) Ничего не генерирует.
5)
спецификация
noexcept:
noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)
Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).
Пример
#include <iomanip> #include <iostream> #include <string> void print(std::string::size_type n, std::string::size_type len, std::string const &s) { if (n == std::string::npos) std::cout << "не найдено\n"; else std::cout << "найдено: " << std::quoted(s.substr(n, len)) << " в " << n << '\n'; } int main() { std::string::size_type n; std::string const s = "This is a string"; // поиск назад от конца строки n = s.rfind("is"); print(n, 2, s); // поиск назад, начиная с позиции 4 n = s.rfind("is", 4); print(n, 2, s); // поиск одного символа n = s.rfind('s'); print(n, 1, s); // поиск одного символа n = s.rfind('q'); print(n, 1, s); // поиск префикса (смотрите также s.starts_with("This")) n = s.rfind("This", 0); print(n, 4, s); }
Вывод:
найдено: "is" в 5 найдено: "is" в 2 найдено: "s" в 10 не найдено найдено: "This" в 0
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| 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>) [править]
|