allocator::construct

Constructs a specific type of object at a specified address that is initialized with a specified value.

void construct( 
   pointer _Ptr,  
   const Type& _Val 
); 
void construct( 
   pointer _Ptr,  
   Type&& _Val 
); 
template<class _Other> 
    void construct( 
        pointer _Ptr,  
        _Other&&... _Val 
    );

Parameters

  • _Ptr
    A pointer to the location where the object is to be constructed.

  • _Val
    The value with which the object being constructed is to be initialized.

Remarks

The first member function is equivalent to new ( (void *) _Ptr ) Type ( _Val ).

Example

// allocator_construct.cpp
// compile with: /EHsc
#include <memory>
#include <iostream>
#include <algorithm>
#include <vector>

using namespace std;

int main( ) 
{
   vector <int> v1;
   vector <int>::iterator v1Iter;
   vector <int>:: allocator_type v1Alloc;

   int i;
   for ( i = 1 ; i <= 7 ; i++ )
   {
      v1.push_back( 3 * i );
   }

   cout << "The original vector v1 is:\n ( " ;
   for ( v1Iter = v1.begin( ) ; v1Iter != v1.end( ) ; v1Iter++ )
      cout << *v1Iter << " ";
   cout << ")." << endl;

   allocator<int>::pointer v1PtrA;
   int kA = 6, kB = 7;
   v1PtrA = v1Alloc.address( *find( v1.begin( ), v1.end( ), kA ) );
   v1Alloc.destroy ( v1PtrA );
   v1Alloc.construct ( v1PtrA , kB );

   cout << "The modified vector v1 is:\n ( " ;
   for ( v1Iter = v1.begin( ) ; v1Iter != v1.end( ) ; v1Iter++ )
      cout << *v1Iter << " ";
   cout << ")." << endl;
}
The original vector v1 is:
 ( 3 6 9 12 15 18 21 ).
The modified vector v1 is:
 ( 3 7 9 12 15 18 21 ).

Requirements

Header: <memory>

Namespace: std

See Also

Reference

allocator Class

Lvalues and Rvalues

Lvalue Reference Declarator: &

Rvalue Reference Declarator: &&