Biblioteca de algoritmos C ++ - função includes ()

Descrição

A função C ++ std::algorithm::includes()teste se o primeiro conjunto é um subconjunto de outro ou não. Esta função de membro espera elementos em ordem classificada. Ele usa função binária para comparação.

Declaração

A seguir está a declaração para o cabeçalho da função std :: algorithm :: includes ()

C ++ 98

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

Parâmetros

  • first1 - Insira o iterador na posição inicial da primeira sequência.

  • last1 - Insira o iterador na posição final da primeira sequência.

  • first2 - Insira o iterador na posição inicial da segunda sequência.

  • last2 - Insira o iterador na posição final da segunda sequência.

  • comp - Uma função binária que aceita dois argumentos e retorna bool.

Valor de retorno

Retorna verdadeiro se o primeiro conjunto for um subconjunto de outro, caso contrário, retorna falso.

Exceções

Lança exceção se a comparação de elemento ou uma operação em um iterador lança exceção.

Observe que os parâmetros inválidos causam um comportamento indefinido.

Complexidade de tempo

Linear.

Exemplo

O exemplo a seguir mostra o uso da função std :: algorithm :: 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;
}

Vamos compilar e executar o programa acima, isso produzirá o seguinte resultado -

Vector v2 is subset of v1