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 が常に返されます。

例外

何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません（ strong exception safety guarantee ）。

例

#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++規格に対して遡及的に適用されました。

関連項目