Compartilhar via


generate

Atribui os valores gerados por um objeto da função a cada elemento em um intervalo.

template<class ForwardIterator, class Generator> 
   void generate( 
      ForwardIterator _First,  
      ForwardIterator _Last,  
      Generator _Gen 
   );

Parâmetros

  • _First
    Um iterador para que trata a posição do primeiro elemento no intervalo no qual os valores devem ser atribuídos.

  • _Last
    Um iterador para que trata a posição uma depois do elemento final do intervalo no qual os valores devem ser atribuídos.

  • _Gen
    Um objeto de função que é chamado sem argumentos que é usado para gerar os valores a serem atribuídas a cada um dos elementos no intervalo.

Comentários

O objeto da função será invocado para cada elemento no intervalo e não precisa retornar o mesmo valor sempre que é chamado. Pode, por exemplo, ler de um arquivo ou consultar e modificar um estado local. O tipo de resultado de gerador deve ser convertido no tipo de valor dos iteradores encaminhados para o intervalo.

O intervalo referenciado deve ser válido; todos os ponteiros devem ser dereferenceable e, na sequência, a posição da última deve ser possível acessá-lo do pela primeira incrementação.

A complexidade é linear, exatamente com_Last (–)_Firstchamadas para o gerador que está sendo necessário.

Exemplo

// alg_generate.cpp
// compile with: /EHsc
#include <vector>
#include <deque>
#include <algorithm>
#include <iostream>
#include <ostream>

int main( )
{
   using namespace std;

   // Assigning random values to vector integer elements
   vector <int> v1 ( 5 );
   vector <int>::iterator Iter1;
   deque <int> deq1 ( 5 );
   deque <int>::iterator d1_Iter;
   
   generate ( v1.begin ( ), v1.end ( ) , rand );
   
   cout << "Vector v1 is ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")." << endl;

   // Assigning random values to deque integer elements
   generate ( deq1.begin ( ), deq1.end ( ) , rand );

   cout << "Deque deq1 is ( " ;
   for ( d1_Iter = deq1.begin( ) ; d1_Iter != deq1.end( ) ; d1_Iter++ )
      cout << *d1_Iter << " ";
   cout << ")." << endl;
}
  

Requisitos

Cabeçalho: <algoritmo>

Namespace: std

Consulte também

Referência

gerar (Exemplos da STL)

Biblioteca de Modelos Padrão