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 o operador < 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>
bool includes(InputIterator1 first1, InputIterator1 last1,
   InputIterator2 first2, InputIterator2 last2);

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.

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;

int main(void) {
   vector<int> v1 = {1, 2, 3, 4, 5};
   vector<int> v2 = {3, 4, 5};
   bool result;

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

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

   v2 = {10};

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

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

   return 0;
}

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

Vector v2 is subset of v1
Vector v2 is not subset of v1