C++ 算法库 - find_first_of() 函数

---

描述

C++ 函数std::algorithm::find_first_of()返回一个迭代器，指向(first1,last1)范围内与first2,last2中的任何元素匹配的第一个元素。如果没有找到这样的元素，该函数返回last1。

宣言

以下是 std::algorithm::find_first_of() 函数形式 std::algorithm 标头的声明。

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.