generate_n

スコープの指定された数の要素に関数オブジェクトによって生成される値を割り当て、値が割り当てられている最後の一つ前の位置 1 に戻ります。

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

パラメーター

  • _First
    値が割り当てられた範囲の最初の要素の位置を示す出力反復子。

  • _Count
    ジェネレーター関数によって値が割り当てられている要素の数を指定する符号付きまたは符号なし整数の型。

  • _Gen
    引数なしで呼び出される関数オブジェクト範囲内の各要素に割り当てる値を生成する。

解説

関数オブジェクトは、範囲内の各要素に対して呼び出されるたびに開始され、同じ値を返す必要がありません。これは、たとえば、ファイルから読み取りまたはローカル状態を変更するには、表示されることがあります。ジェネレーターの結果の型のスコープの前方反復子の値型に変換できる必要があります。

参照される範囲が有効である必要があります; すべてのポインターが dereferenceable、シーケンス内では、最後の位置は incrementation によって最初から到達できる必要があります。

複雑度は、必要なジェネレーターに _Count の呼び出しとまったく線形、です。

generate_n 2 に関連する二つの形式があります:

ついては、これらの関数がどのようにするか、チェックを行う反復子を参照してください。

使用例

// 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;
}

出力

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

必要条件

ヘッダー: <algorithm>

名前空間: std

参照

関連項目

generate_n (STL Samples)

標準テンプレート ライブラリ