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). Если в качестве 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";
    // поиск с конца строки
    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++.

Смотрите также