Libreria di algoritmi C ++: funzione include ()

Descrizione

La funzione C ++ std::algorithm::includes()verifica se il primo insieme è un sottoinsieme di un altro o meno. Questa funzione membro prevede che gli elementi siano ordinati. Usa la funzione binaria per il confronto.

Dichiarazione

Di seguito è la dichiarazione per std :: algoritmo :: include () modulo di funzione std :: intestazione algoritmo.

C ++ 98

template <class InputIterator1, class InputIterator2, class Compare>
bool includes(InputIterator1 first1, InputIterator1 last1,
   InputIterator2 first2, InputIterator2 last2, Compare comp);

Parametri

  • first1 - Input iteratore alla posizione iniziale della prima sequenza.

  • last1 - Input iteratore alla posizione finale della prima sequenza.

  • first2 - Input iteratore alla posizione iniziale della seconda sequenza.

  • last2 - Input iteratore alla posizione finale della seconda sequenza.

  • comp - Una funzione binaria che accetta due argomenti e restituisce bool.

Valore di ritorno

Restituisce vero se il primo insieme è un sottoinsieme di un altro altrimenti restituisce falso.

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 :: includes ().

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

using namespace std;

bool compare(char a, char b) {
   return (tolower(a) == tolower(b));
}

int main(void) {
   vector<char> v1 = {'a', 'b', 'c', 'd', 'e'};
   vector<char> v2 = {'C', 'D', 'E'};
   bool result;

   result = includes(v1.begin(), v1.end(), v2.begin(), v2.end(), compare);

   if (result == true)
      cout << "Vector v2 is subset of v1" << endl;

   return 0;
}

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

Vector v2 is subset of v1