std::basic_string<CharT,Traits,Allocator>:: rfind
|
size_type rfind
(
const
basic_string
&
str, size_type pos
=
npos
)
const
;
|
(1) |
(noexcept начиная с C++11)
(constexpr начиная с C++20) |
|
size_type rfind
(
const
CharT
*
s, size_type pos, size_type count
)
const
;
|
(2) | (constexpr начиная с C++20) |
|
size_type rfind
(
const
CharT
*
s, size_type pos
=
npos
)
const
;
|
(3) | (constexpr начиная с C++20) |
|
size_type rfind
(
CharT ch, size_type pos
=
npos
)
const
;
|
(4) |
(noexcept начиная с C++11)
(constexpr начиная с C++20) |
|
template
<
class
StringViewLike
>
size_type rfind
(
const
StringViewLike
&
t,
|
(5) |
(начиная с C++17)
(constexpr начиная с C++20) |
Находит последнюю подстроку, равную заданной последовательности символов. Поиск начинается с позиции pos и выполняется справа налево (таким образом, найденная подстрока, если таковая имеется, не может начинаться в позиции, следующей за pos ). Если передано значение npos или любое значение не меньшее, чем size() - 1 , будет выполнен поиск по всей строке.
[
s
,
s
+
count
)
. Этот диапазон может включать нулевые символы.
[
s
,
s
+
Traits
::
length
(
s
)
)
не является
допустимым диапазоном
, поведение не определено.
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 .
Исключения
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Пример
#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 << "not found\n"; else std::cout << "found: " << std::quoted(s.substr(n, len)) << " at " << 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); }
Вывод:
found: "is" at 5 found: "is" at 2 found: "s" at 10 not found found: "This" at 0
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам 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>
)
|