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

Находит последнюю подстроку, равную заданной последовательности символов. Поиск начинается с 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 << "не найдено\n";
    else
        std::cout << "найдено: " << std::quoted(s.substr(n, len)) << " в " << 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);
}

найдено: "is" в 5
найдено: "is" в 2
найдено: "s" в 10
не найдено
найдено: "This" в 0

[править] Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

[править] Смотрите также