C++

参考

<string>

basic_string

public member function
<string>

std::basic_string::find_first_of

string (1)
size_type find_first_of (const basic_string& str, size_type pos = 0) const;
c-string (2)
size_type find_first_of (const charT* s, size_type pos = 0) const;
buffer (3)
size_type find_first_of (const charT* s, size_type pos, size_type n) const;
character (4)
size_type find_first_of (charT c, size_type pos = 0) const;
string (1)
size_type find_first_of (const basic_string& str, size_type pos = 0) const noexcept;
c-string (2)
size_type find_first_of (const charT* s, size_type pos = 0) const;
buffer (3)
size_type find_first_of (const charT* s, size_type pos, size_type n) const;
character (4)
size_type find_first_of (charT c, size_type pos = 0) const noexcept;
在字符串中查找字符
在basic_string中搜索与参数中指定的任何字符匹配的第一个字符。

当指定pos时，搜索仅包括位置pos处或之后的字符，忽略pos之前的任何可能出现的匹配项。

请注意，序列中的单个字符匹配就足够了（并非全部）。 有关匹配整个序列的函数，请参见basic_string::find。

该函数使用traits_type::eq来确定字符的等价性。

参数

str
另一个包含要搜索的字符的basic_string。
pos
搜索中要考虑的字符串中第一个字符的位置。
如果大于字符串长度，则该函数永远找不到匹配项。
注意：第一个字符用值表示0(不是1): 一个值为0表示搜索整个字符串。
s
指向字符数组的指针。
如果指定了参数n(3)，则搜索数组中的前n个字符。
否则(2)，期望一个以 null 结尾的序列：要匹配的字符序列的长度由第一个 null 字符的出现决定。
n
要搜索的字符值的数量。
c
要搜索的单个字符。

charT是 basic_string 的字符类型（即，它的第一个模板参数）。
成员类型size_type是一种无符号整型类型。

返回值

第一个匹配字符的位置。
如果未找到任何匹配项，该函数将返回basic_string::npos。

成员类型size_type是一种无符号整型类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
// string::find_first_of
#include <iostream>
#include <string>

int main ()
{
  std::string str ("PLease, replace the vowels in this sentence by asterisks.");
  std::string::size_type found = str.find_first_of("aeiou");
  while (found!=std::string::npos)
  {
    str[found]='*';
    found=str.find_first_of("aeiou",found+1);
  }

  std::cout << str << '\n';

  return 0;
}
 

Pl**s*, r*pl*c* th* v*w*ls *n th*s s*nt*nc* by *st*r*sks.


复杂度

未指定，但通常与length()-pos乘以要匹配的字符数成线性关系（最坏情况）。

迭代器有效性

没有变化。

数据竞争

该对象被访问。

异常安全

如果已知s未指向足够长的数组，会导致未定义行为。
否则，该函数永远不会抛出异常（无抛出保证）。

另见

basic_string::find
查找字符串中第一次出现(公共成员函数)
basic_string::find_last_of
从字符串末尾查找字符 (公共成员函数)
basic_string::find_first_not_of
在字符串中查找非匹配字符 (公共成员函数)
basic_string::replace
替换字符串的一部分 (public member function)
basic_string::substr
生成子字符串 (公共成员函数)