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

描述

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

宣告

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

C++98

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

引數

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

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

返回值

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

異常

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

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

時間複雜度

線性於first和last.

之間的距離。

示例

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

using namespace std;

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

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

   v[3] = 4;

   it = adjacent_find(v.begin(), v.end());

   if (it == v.end())
      cout << "There are no cosecutive identical elemens" << endl;

   return 0;
}

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

First occurrence of consecutive identical element = 3
There are no cosecutive identical elemens