Namespaces
Variants

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

From cppreference.net
std::basic_string
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,

size_type pos = npos ) const noexcept ( /* см. ниже */ ) ;
(5) (начиная с C++17)
(constexpr начиная с C++20)

Находит последнюю подстроку, равную заданной последовательности символов. Поиск начинается с позиции pos и выполняется справа налево (таким образом, найденная подстрока, если таковая имеется, не может начинаться в позиции, следующей за pos ). Если передано значение npos или любое значение не меньшее, чем size() - 1 , будет выполнен поиск по всей строке.

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 если такая подстрока не найдена. Обратите внимание, что это смещение от начала строки, а не от конца.

Если производится поиск пустой строки (т.е., 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 << "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> )