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
生成子字串 (公共成員函式)