A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://www.tutorialspoint.com/cpp_standard_library/cpp_algorithm_adjacent_find.htm below:

C++ adjacent_find Function

C++ Algorithm Library - adjacent_find() Function Description

The C++ function std::algorithm::adjacent_find() finds the first occurrence of two consecutive elements that are identical and returns an iterator pointing to the first element if identical element exists consecutively otherwise returns an iterator pointing to the last element.

Declaration

Following is the declaration for std::algorithm::adjacent_find() function form std::algorithm header.

C++98
template <class ForwardIterator>
ForwardIterator adjacent_find(ForwardIterator first, ForwardIterator last);
Parameters Return value

Returns an iterator pointing to the first element if identical element exists consecutively otherwise returns an iterator pointing to the last element.

Exceptions

Exception is thrown if any element comparison object throws exception.

Please note that invalid arguments cause undefined behavior.

Time complexity

Linear in the distance between first and last.

Example

The following example shows the usage of std::algorithm::adjacent_find() function.

#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;
}

Let us compile and run the above program, this will produce the following result −

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

algorithm.htm


RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4