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

查找首个与给定字符序列相等的子串。搜索从 pos 开始，即找到的子串起始位置不得早于 pos 。

形式上，当满足以下所有条件时，称子串 str 在位置 xpos 被 找到 ：

• xpos >= pos
• xpos + str. size ( ) <= size ( )
• 对于 str 中的所有位置 n ，满足 Traits :: eq ( at ( xpos + n ) , str. at ( n ) ) 。

具体而言，这意味着

• 仅当 pos <= size ( ) - str. size ( ) 时才能找到子串
• 当且仅当 pos <= size ( ) 时，可以在该位置找到空子串
• 对于非空子串，若 pos >= size ( ) ，函数始终返回 npos

参数

返回值

找到的子串首字符位置，若未找到该子串则返回 npos 。

异常

若因任何原因抛出异常，此函数不产生任何效果（ 强异常安全保证 ）。

示例

#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++标准。

参见