Libreria di algoritmi C ++: funzione find_first_of ()

Descrizione

La funzione C ++ std::algorithm::find_first_of()restituisce un iteratore al primo elemento nell'intervallo di (first1, last1) che corrisponde a uno qualsiasi degli elementi in first2, last2 . Se non viene trovato alcun elemento di questo tipo, la funzione restituisce last1 .

Dichiarazione

Di seguito è riportata la dichiarazione per std :: algoritmo :: find_first_of () modulo std :: intestazione algoritmo.

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);

Parametri

  • first1 - Inoltra l'iteratore alla posizione iniziale della prima sequenza.

  • last1 - Inoltra l'iteratore alla posizione finale della prima sequenza.

  • first2 - Inoltra l'iteratore alla posizione iniziale della seconda sequenza.

  • last2 - Inoltra l'iteratore alla posizione finale della seconda sequenza.

Valore di ritorno

Restituisce un iteratore al primo elemento nell'intervallo di (first1, last1) che corrisponde a uno qualsiasi degli elementi in first2, last2 . Se non viene trovato alcun elemento di questo tipo, la funzione restituisce last1 .

Eccezioni

Genera un'eccezione se il confronto di elementi o un'operazione su un iteratore genera un'eccezione.

Tieni presente che i parametri non validi causano un comportamento indefinito.

Complessità temporale

Lineare.

Esempio

L'esempio seguente mostra l'utilizzo della funzione std :: algoritmo :: 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;
}

Compiliamo ed eseguiamo il programma sopra, questo produrrà il seguente risultato:

Found first match at location 3
Sequence doesn't found.