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> ForwardIterator1 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2, ForwardIterator2 last2);
C++11
template <class InputIterator, class ForwardIterator> ForwardIterator1 find_first_of(InputIterator first1, InputIterator last1, ForwardIterator first2, ForwardIterator last2);
参数
first1 − 将迭代器转发到第一个序列的初始位置。
last1 − 将迭代器转发到第一个序列的最终位置。
first2 − 将迭代器转发到第二个序列的初始位置。
last2 − 将迭代器转发到第二个序列的最终位置。
返回值
返回一个迭代器,指向 (first1,last1) 范围内与 first2,last2 中的任何元素匹配的第一个元素。 如果没有找到这样的元素,则函数返回 last1。
异常
如果元素比较或迭代器上的操作引发异常,则引发异常。
请注意,无效参数会导致未定义的行为。
时间复杂度
Linear.
示例
以下示例显示了 std::algorithm::find_first_of() 函数的用法。
#include <iostream> #include <vector> #include <algorithm> using namespace std; int main(void) { vector<int> v1 = {5, 2, 6, 1, 3, 4, 7}; vector<int> v2 = {10, 1}; auto result = find_first_of(v1.begin(), v1.end(), v2.begin(), v2.end()); if (result != v1.end()) cout << "Found first match at location " << distance(v1.begin(), result) << endl; v2 = {11, 13}; result = find_end(v1.begin(), v1.end(), v2.begin(), v2.end()); if (result == v1.end()) cout << "Sequence doesn't found." << endl; return 0; }
让我们编译并运行上面的程序,这将产生以下结果 −
Found first match at location 3 Sequence doesn't found.