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

指定された文字シーケンスと等しい最初の部分文字列を検索します。検索は pos から開始され、つまり見つかった部分文字列は pos より前の位置から始まっていてはなりません。

形式的には、部分文字列 str は、以下の条件がすべて true である場合に位置 xpos で 見つかった とされます：

• xpos >= pos
• xpos + str. size ( ) <= size ( )
• str 内の全ての位置 n について、 Traits :: eq ( at ( xpos + n ) , str. at ( n ) ) が成り立つ。

特に、これは以下を意味します。

• 部分文字列が見つかるのは、 pos <= size ( ) - str. size ( ) の場合のみです。
• 空の部分文字列は、 pos の位置で見つかるのは、 pos <= size ( ) の場合に限ります。
• 空でない部分文字列の場合、 pos >= size ( ) の場合、関数は常に npos を返します。

パラメータ

戻り値

見つかった部分文字列の最初の文字の位置、または npos そのような部分文字列が見つからない場合。

例外

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

例

#include <iomanip>
#include <iostream>
#include <string>
void print(int id, std::string::size_type n, std::string const& s)
{
    std::cout << id << ") ";
    if (std::string::npos == n)
        std::cout << "not found! n == npos\n";
    else
        std::cout << "found @ n = " << n << ", substr(" << n << ") = "
                  << std::quoted(s.substr(n)) << '\n';
}
int main()
{
    std::string::size_type n;
    std::string const s = "This is a string"; /*
                             ^  ^  ^
                             1  2  3          */
    // 文字列の先頭から検索
    n = s.find("is");
    print(1, n, s);
    // 位置5から検索
    n = s.find("is", 5);
    print(2, n, s);
    // 単一文字を検索
    n = s.find('a');
    print(3, n, s);
    // 単一文字を検索
    n = s.find('q');
    print(4, n, s);
}

1) found @ n = 2, substr(2) = "is is a string"
2) found @ n = 5, substr(5) = "is a string"
3) found @ n = 8, substr(8) = "a string"
4) not found! n == npos

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目