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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

Позиция первого символа найденной подстроки или 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";
 
    // 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++.

См. также