C++ 演算法庫 - find_first_of() 函式

描述

C++ 函式std::algorithm::find_first_of() 返回一個迭代器，指向範圍內的第一個元素(first1,last1)該元素與任何一個元素匹配first2,last2。如果沒有找到這樣的元素，則函式返回last1.

宣告

以下是來自 std::algorithm 標頭檔案的 std::algorithm::find_first_of() 函式宣告。

C++98

template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
ForwardIterator1 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
   ForwardIterator2 first2, ForwardIterator2 last2,BinaryPredicate pred);

C++11

template <class InputIterator, class ForwardIterator, class BinaryPredicate>
ForwardIterator1 find_first_of(InputIterator first1, InputIterator last1,
   ForwardIterator first2, ForwardIterator last2,BinaryPredicate pred);

引數

• first1 − 指向第一個序列初始位置的正向迭代器。

• last1 − 指向第一個序列最終位置的正向迭代器。

• first2 − 指向第二個序列初始位置的正向迭代器。

• last2 − 指向第二個序列最終位置的正向迭代器。

• pred − 一個二元謂詞，接受兩個引數並返回一個布林值。

返回值

返回一個迭代器，指向範圍內的第一個元素(first1,last1)該元素與任何一個元素匹配first2,last2。如果沒有找到這樣的元素，則函式返回last1.

異常

如果元素比較或迭代器上的操作丟擲異常，則丟擲異常。

請注意，無效引數會導致未定義的行為。

時間複雜度

線性。

示例

以下示例演示了 std::algorithm::find_first_of() 函式的使用方法。

#include <iostream>
#include <vector>
#include <algorithm>

using namespace std;

bool binary_pred(char a, char b) {
   return (tolower(a) == tolower(b));
}

int main(void) {
   vector<char> v1 = {'f', 'c', 'e', 'd', 'b', 'a'};
   vector<char> v2 = {'D', 'F'};
 
   auto result = find_first_of(v1.begin(), v1.end(), v2.begin(), v2.end(), binary_pred);

   if (result != v1.end())
      cout << "Found first match at location " 
         << distance(v1.begin(), result) << endl;

   v2 = {'x', 'y'};

   result = find_end(v1.begin(), v1.end(), v2.begin(), v2.end(), binary_pred);

   if (result == v1.end())
      cout << "Sequence doesn't found." << endl;

   return 0;
}

讓我們編譯並執行上面的程式，這將產生以下結果：

Found first match at location 0
Sequence doesn't found.