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

size_type rfind( const basic_string& str, size_type pos = npos ) const;

size_type rfind( const CharT* s, size_type pos, size_type count ) const;

size_type rfind( const CharT* s, size_type pos = npos ) const;

size_type rfind( CharT ch, size_type pos = npos ) const;

template< class StringViewLike >
size_type rfind( const StringViewLike& t,
                 size_type pos = npos ) const noexcept(/* see below */);

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

Во всех случаях равенство проверяется вызовом Traits::eq.

Параметры

Возвращаемое значение

Позиция первого символа найденной подстроки или npos, если такая подстрока не найдена. Обратите внимание, что это смещение от начала строки, а не от её конца.

При поиске пустой строки (то есть если str.size(), count или Traits::length(s) равно нулю) пустая строка находится сразу, и rfind возвращает:

• pos, если pos < size();
• size() в остальных случаях, в том числе если pos == npos.

В противном случае, если size() равно нулю, всегда возвращается npos.

Исключения

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";
    
    // search backwards from end of string
    n = s.rfind("is");
    print(n, 2, s);
    
    // search backwards from position 4
    n = s.rfind("is", 4);
    print(n, 2, s);
    
    // find a single character
    n = s.rfind('s');
    print(n, 1, s);
    
    // find a single character
    n = s.rfind('q');
    print(n, 1, s);
    
    // find the prefix (see also 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++.

См. также