C++ Algorithm 库 - 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。
异常
如果元素比较或迭代器上的操作引发异常，则引发异常。
请注意，无效参数会导致未定义的行为。
时间复杂度
Linear.
示例
以下示例显示了 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.
