Share via


uninitialized_fill_n

指定された値のオブジェクトを、初期化されていないターゲット範囲にある指定された数の要素にコピーします。

template<class FwdIt, class Size, class Type> 
   void uninitialized_fill_n( 
      ForwardIterator _First,  
      Size _Count, 
      const Type& _Val 
   );

パラメーター

  • _First
    初期化されるターゲット範囲内の先頭の要素を示す前方反復子。

  • _Count
    初期化される要素の数。

  • _Val
    ターゲット範囲を初期化するために使用される値。

解説

このアルゴリズムによって、オブジェクトの構築からメモリの割り当てを分離できます。

このテンプレート関数は、実質的に次の内容を実行します。

while ( 0 < count-- )
   new ( ( void * )&*_First ++ )
      iterator_traits<ForwardIterator>::value_type( _Val );

ただし、このコードが例外をスローする場合を除きます。 この場合は、構築されたオブジェクトはすべて破棄され、再度例外がスローされます。

使用例

// memory_uninit_fill_n.cpp
// compile with: /EHsc /W3
#include <memory>
#include <iostream>

using namespace std;

class Integer {   // No default constructor
public:
   Integer( int x ) : val( x ) {}
   int get( ) { return val; }
private:
   int val;
};

int main() {
   const int N = 10;
   Integer val ( 60 );
   Integer* Array = ( Integer* ) malloc( N * sizeof( int ) );
   uninitialized_fill_n( Array, N, val );  // C4996
   int i;
   cout << "The uninitialized Array contains: ";
   for ( i = 0 ; i < N; i++ )
      cout << Array [ i ].get( ) <<  " ";
}

出力

The uninitialized Array contains: 60 60 60 60 60 60 60 60 60 60 

必要条件

ヘッダー: <memory>

名前空間: std