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

描述

C++ 函式std::algorithm::adjacent_find() 查詢第一次出現的兩個連續且相同的元素，如果存在連續相同的元素，則返回指向第一個元素的迭代器；否則返回指向最後一個元素的迭代器。

宣告

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

template <class ForwardIterator, class BinaryPredicate>
ForwardIterator adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);

引數

• first − 指向搜尋序列初始位置的正向迭代器。

• last − 指向搜尋序列最終位置的正向迭代器。

• pred − 此函式接受兩個引數並返回bool.

返回值

如果存在連續相同的元素，則返回指向第一個元素的迭代器；否則返回指向最後一個元素的迭代器。

異常

如果任何元素比較物件丟擲異常，則會丟擲異常。

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

時間複雜度

在兩者之間的距離上是線性的first和last.

示例

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

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

using namespace std;

bool predicate(int a, int b) {
   return (a == b);
}

int main(void) {
   vector<int> v = {1, 2, 3, 3, 4, 5, 5};
   auto it = adjacent_find(v.begin(), v.end());

   if (it != v.end())
      cout << "First occurrence of consecutive identical element = "
         << *it << endl;

   it = adjacent_find(++it, v.end(), predicate);

   if (it != v.end())
      cout << "Second occurrence of consecutive identical element = "
         << *it << endl;

   return 0;
}

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

First occurrence of consecutive identical element = 3
Second occurrence of consecutive identical element = 5