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

< cpp‎ | string‎ | basic string

| (1) |
size_type rfind( const basic_string& str, size_type pos = npos ) const; |  | (C++11 前)
size_type rfind( const basic_string& str, size_type pos = npos ) const noexcept; |  | (C++11 起) (C++20 前)
constexpr size_type rfind( const basic_string& str, size_type pos = npos ) const noexcept; |  | (C++20 起)
| (2) |
size_type rfind( const CharT* s, size_type pos, size_type count ) const; |  | (C++20 前)
constexpr size_type rfind( const CharT* s, size_type pos, size_type count ) const; |  | (C++20 起)
| (3) |
size_type rfind( const CharT* s, size_type pos = npos ) const; |  | (C++20 前)
constexpr size_type rfind( const CharT* s, size_type pos = npos ) const; |  | (C++20 起)
| (4) |
size_type rfind( CharT ch, size_type pos = npos ) const; |  | (C++11 前)
size_type rfind( CharT ch, size_type pos = npos ) const noexcept; |  | (C++11 起) (C++20 前)
constexpr size_type rfind( CharT ch, size_type pos = npos ) const noexcept; |  | (C++20 起)
| (5) |
template < class T > size_type rfind( const T& t, size_type pos = npos ) const noexcept(/* see below */); |  | (C++17 起) (C++20 前)
template < class T > constexpr size_type rfind( const T& t, size_type pos = npos ) const noexcept(/* see below */); |  | (C++20 起)

寻找等于给定字符序列的最后子串。搜索始于 `pos` ，即找到的子串必须不始于 `pos` 后的位置。若将 npos 或任何不小于 size()-1 的值作为 `pos` 传递，则在整个字符串中搜索。

1) 寻找等于 `str` 的最后子串。
2) 寻找等于范围 `[s, s+count)` 的最后子串。此范围能包含空字符。
3) 寻找等于 `s` 所指向的字符串的最后子串。由首个空字符，用 `Traits::length(s)` 确定字符串长度。
4) 寻找等于 `ch` 的最后字符。
5) 如同用 std::basic_string_view<CharT, Traits> sv = t; 隐式转换 `t` 为 string_view `sv` ，然后寻找等于 `sv` 内容的最后子串。此重载仅若 std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> 为 true 且 std::is_convertible_v<const T&, const CharT*> 为 false 才参与重载决议。

所有情况下均调用 `Traits::eq` 检查相等性。

### 参数

str | - | 要搜索的 string
pos | - | 开始搜索的位置
count | - | 要搜索的子串长度
s | - | 指向要搜索的字符串的指针
ch | - | 要搜索的字符
t | - | 要搜索的对象（可转换为 std::basic_string_view ）

### 返回值

找到的子串的首字符位置，或若找不到这种子串则为 npos 。注意这是从字符串开始，而非末尾的偏移。

若搜索任何空字符串（ str.size() 、 count 或 Traits::length(s) 为零），则返回 `pos` （立即找到空字符串），除非 pos > size() （包括 pos == npos 的情况），该情况下返回 size() 。

否则，若 size() 为零，则始终返回 npos 。

### 异常

5)
`noexcept` 说明：
noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)

### 示例

    #include <string>
    #include <iostream>

    void print(std::string::size_type n, std::string const &s)
    {
        if (n == std::string::npos) {
            std::cout << "not found\n";
        } else {
            std::cout << "found: \"" << s.substr(n) << "\" at " << n << '\n';
        }
    }

    int main()
    {
        std::string::size_type n;
        std::string const s = "This is a string";

        // 从字符串尾反向搜索
        n = s.rfind("is");
        print(n, s);
        // 从位置 4 反向搜索
        n = s.rfind("is", 4);
        print(n, s);
        // 寻找单个字符
        n = s.rfind('s');
        print(n, s);
        // 寻找单个字符
        n = s.rfind('q');
        print(n, s);
    }

输出：

    found: "is a string" at 5
    found: "is is a string" at 2
    found: "string" at 10
    not found

### 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR | 应用于 | 出版时的行为 | 正确行为
--- | --- | --- | ---
LWG 2064 | C++11 | 重载 (3) 与 (4) 为 noexcept | 移除
LWG 2946 | C++17 | `string_view` 重载在某些情况下导致歧义 | 通过使之为模板来避免
P1148R0 | C++11 C++17 | 重载 (4)/(5) 的 noexcept 意外地被 LWG2064/LWG2946 丢弃 | 恢复

### 参阅

find | 于字符串中寻找字符 (公开成员函数)
find_first_of | 寻找字符的首次出现 (公开成员函数)
find_first_not_of | 寻找字符的首次缺失 (公开成员函数)
find_last_of | 寻找字符的最后一次出现 (公开成员函数)
find_last_not_of | 寻找字符的最后一次缺失 (公开成员函数)