Просмотр кода страницы cpp/string/basic string/rfind

У вас нет прав на выполнение действия «редактирование этой страницы» по следующей причине:

Запрошенное действие могут выполнять участники одной из следующих групп: Участники, Администраторы.

Вы можете просмотреть и скопировать исходный код этой страницы.

{{cpp/string/basic_string/title|rfind}}
{{cpp/string/basic_string/navbar}}
{{dcl begin}}
{{dcl rev multi|num=1
|dcl1=
size_type rfind( const basic_string& str, size_type pos = npos ) const;
|since2=c++11|dcl2=
size_type rfind( const basic_string& str,
                 size_type pos = npos ) const noexcept;
|since3=c++20|dcl3=
constexpr size_type rfind( const basic_string& str,
                           size_type pos = npos ) const noexcept;
}}
{{dcl rev multi|num=2
|dcl1=
size_type rfind( const CharT* s, size_type pos, size_type count ) const;
|since2=c++20|dcl2=
constexpr size_type rfind( const CharT* s,
                           size_type pos, size_type count ) const;
}}
{{dcl rev multi|num=3
|dcl1=
size_type rfind( const CharT* s, size_type pos = npos ) const;
|since2=c++20|dcl2=
constexpr size_type rfind( const CharT* s, size_type pos = npos ) const;
}}
{{dcl rev multi|num=4
|dcl1=
size_type rfind( CharT ch, size_type pos = npos ) const;
|since2=c++11|dcl2=
size_type rfind( CharT ch, size_type pos = npos ) const noexcept;
|since3=c++20|dcl3=
constexpr size_type rfind( CharT ch, size_type pos = npos ) const noexcept;
}}
{{dcl rev multi|num=5
|since1=c++17|dcl1=
template< class StringViewLike >
size_type rfind( const StringViewLike& t,
                 size_type pos = npos ) const noexcept(/* смотрите ниже */);
|since2=c++20|dcl2=
template< class StringViewLike >
constexpr size_type
    rfind( const StringViewLike& t,
           size_type pos = npos ) const noexcept(/* смотрите ниже */);
}}
{{dcl end}}

Находит последнюю подстроку, равную заданной последовательности символов. Поиск начинается с {{c|pos}} и продолжается справа налево (таким образом, найденная подстрока, если таковая имеется, не может начинаться с позиции, следующей за {{c|pos}}). Если {{lc|npos}} или любое значение не меньшее {{box|{{lc|size()}}{{c/core| - 1}}}} передаётся как {{c|pos}}, поиск будет осуществляться по всей строке.

@1@ Находит последнюю подстроку, равную {{c|str}}.

@2@ Находит последнюю подстроку, равную диапазону {{range|s|s + count}}. Этот диапазон может включать нулевые символы.

@@ Если {{range|s|s + count}} не является [[cpp/iterator#Диапазоны|действительным диапазоном]], поведение не определено.

@3@ Находит последнюю подстроку, равную строке символов, на которую указывает {{c|s}}. Длина строки определяется по первому нулевому символу с помощью {{c|Traits::length(s)}}.

@@ Если {{range|s|s + Traits::length(s)}} не является [[cpp/iterator#Диапазоны|действительным диапазоном]], поведение не определено.

@4@ Находит последний символ, равный {{c|ch}}.

@5@ {{cpp/string/sv hack|находит последнюю подстроку, равную содержимому {{c|sv}}}}

Во всех случаях равенство проверяется вызовом {{ltt|cpp/string/char_traits/cmp|Traits::eq}}.

===Параметры===
{{par begin}}
{{par|str|строка для поиска}}
{{par|pos|позиция, с которой следует начать поиск}}
{{par|count|длина подстроки для поиска}}
{{par|s|указатель на строку символов для поиска}}
{{par|ch|символ для поиска}}
{{par|t|объект (конвертируемый в {{lc|std::basic_string_view}}) для поиска}}
{{par end}}

===Возвращаемое значение===
Позиция первого символа найденной подстроки или {{lc|npos}}, если так��я подстрока не найдена. Обратите внимание, что это смещение от начала строки, а не от конца.

Если осуществляется поиск пустой строки (т.е. {{c|str.size()}}, {{c|count}} или {{c|Traits::length(s)}} равны нулю), пустая строка находится немедленно, и {{tt|rfind}} возвращает:
* {{c|pos}}, если {{c|pos < size()}};
* {{c|size()}} иначе, включая случай, когда {{c|1=pos == npos}}.

Иначе, если {{lc|size()}} равно нулю, всегда возвращается {{lc|npos}}.

===Исключения===
@1,4@ Ничего не генерирует.
@5@ {{noexcept|std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>}}

{{cpp/strong exception safety guarantee}}

===Пример===
{{example
|code=
#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);
}
|output=
найдено: "is" в 5
найдено: "is" в 2
найдено: "s" в 10
не найдено
найдено: "This" в 0
}}

===Отчёты о дефектах===
{{dr list begin}}
{{dr list item|wg=lwg|dr=847|std=C++98|before=не было гарантии безопасности исключений|after=добавлена надё��ная гарантия безопасности исключений}}
{{dr list item|wg=lwg|dr=2064|std=C++11|before=перегрузки {{v|3,4}} были noexcept|after=удалено}}
{{dr list item|wg=lwg|dr=2946|std=C++17|before=перегрузка {{v|5}} в некоторых случаях вызывала<br>двусмысленность|after=исправлено, сделав её шаблоном}}
{{dr list item|paper=P1148R0|std=C++11<br>C++17|before=noexcept перегрузок {{v|4,5}} были случайно<br>удалены LWG2064/LWG2946|after=восстановлены}}
{{dr list end}}

===Смотрите также===
{{dsc begin}}
{{dsc inc|cpp/string/basic_string/dsc find}}
{{dsc inc|cpp/string/basic_string/dsc find_first_of}}
{{dsc inc|cpp/string/basic_string/dsc find_first_not_of}}
{{dsc inc|cpp/string/basic_string/dsc find_last_of}}
{{dsc inc|cpp/string/basic_string/dsc find_last_not_of}}
{{dsc inc|cpp/string/basic_string_view/dsc rfind}}
{{dsc end}}

{{langlinks|de|en|es|fr|it|ja|pt|zh}}

Шаблоны, используемые на этой странице:

Возврат к странице cpp/string/basic string/rfind.

cppreference.com

Поиск

Пространства имён

Варианты

Просмотры

Действия

Просмотр кода страницы cpp/string/basic string/rfind

Навигаци��

Инструменты