generate_n

Atribui os valores gerados por um objeto da função a um número especificado de elementos em um intervalo e retorna a posição um passado o último atribuído ao valor.

template<class OutputIterator, class Diff, class Generator>
   void generate_n(
      OutputIterator _First, 
      Diff _Count, 
      Generator _Gen
   );

Parâmetros

  • _First
    Um iterador de saída que trata a posição do primeiro elemento no intervalo aos valores que devem ser atribuídos.

  • _Count
    Um tipo com sinal ou inteiro sem sinal de que especifica o número de elementos para ser atribuído um valor pelo gerador.

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

Comentários

O objeto da função é chamado para cada elemento no intervalo e não precisa retornar o mesmo valor cada vez que é chamado.Pode, por exemplo, ler de um arquivo ou consultar e modificar um estado local.O tipo do resultado do gerador deve ser conversível para o tipo de valor de iteradores dianteiros para o intervalo.

o intervalo referenciado deve ser válido; todos os ponteiros devem ser dereferenceable e, na seqüência, a posição da última deve ser alcançável da primeira incrementação.

Complexidade é linear, exatamente com chamadas de _Count ao gerador que seja necessária.

generate_n tem dois formulários relacionados:

Para obter informações sobre como essas funções se comportam, consulte Iteradores selecionados.

Exemplo

// alg_generate_n.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_n ( v1.begin ( ), 5 , 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_n ( deq1.begin ( ), 3 , rand );

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

Saída

Vector v1 is ( 41 18467 6334 26500 19169 ).
Deque deq1 is ( 15724 11478 29358 0 0 ).

Requisitos

Cabeçalho: <algorithm>

namespace: STD

Consulte também

Referência

generate_n (STL Samples)

Standard Template Library