uninitialized_copy

Kopie obiektów z zakresu określonego źródła do niezainicjowanej zakresu docelowego.

template<class InputIterator, class ForwardIterator>
   ForwardIterator uninitialized_copy(
      InputIterator _First, 
      InputIterator _Last,
      ForwardIterator _Dest
   );

Parametry

• _First
  Wejściowy iteratora adresowania pierwszy element w zakresie źródłowym.

• _Last
  Wejściowy iteratora adresowania ostatni element w zakresie źródłowym.

• _Dest
  Do przodu iteratora adresowania pierwszy element w zakresie docelowym.

Wartość zwracana

Do przodu iteratora, adresowania pierwsze miejsce poza zakres docelowy, chyba że zakres źródłowy był pusty i adresy iteratora _First.

Uwagi

Algorytm ten umożliwia rozdzielenie alokacji pamięci z konstrukcji obiektów.

Funkcja szablonu skutecznie wykonywana:

while ( _First!= _Last )
   new ( ( void * )&*_Dest ++)
      iterator_traits<InputIterator>::value_type ( *_First ++ );
return _First;

chyba że kod generuje wyjątek.W takim przypadku wszystkie obiekty zbudowane są niszczone i wyjątek jest rethrown.

uninitialized_copy ma dwa formularze pokrewne:

checked_uninitialized_copy

unchecked_uninitialized_copy

Aby uzyskać więcej informacji na zachowanie tych funkcji, zobacz Iteratory zaznaczone.

Przykład

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

using namespace std;

   class Integer 
   {
   public:
      Integer( int x ) : val( x ) {}
      int get( ) { return val; }
   private:
      int val;
   };

int main( )
{
   int Array[] = { 10, 20, 30, 40 };
   const int N = sizeof( Array ) / sizeof( int );

   int i;
   cout << "The initialized Array contains " << N << " elements: ";
      for (i = 0 ; i < N; i++ )
      {
         cout << " " << Array [ i ];
      }
   cout << endl;

   Integer* ArrayPtr = ( Integer* ) malloc( N * sizeof( int ) );
   Integer* LArrayPtr = uninitialized_copy(
      Array, Array + N, ArrayPtr);  // C4996

   cout << "Address of position after the last element in the array is: " 
        << &Array[0] + N << endl;
   cout << "The iterator returned by uninitialized_copy addresses: " 
        << ( void* )LArrayPtr << endl;
   cout << "The address just beyond the last copied element is: " 
        << ( void* )( ArrayPtr + N ) << endl;

   if ( ( &Array[0] + N ) == ( void* )LArrayPtr )
      cout << "The return value is an iterator "
           << "pointing just beyond the original array." << endl;
   else
      cout << "The return value is an iterator "
           << "not pointing just beyond the original array." << endl;

   if ( ( void* )LArrayPtr == ( void* )( ArrayPtr + N ) )
      cout << "The return value is an iterator "
           << "pointing just beyond the copied array." << endl;
   else
      cout << "The return value is an iterator "
           << "not pointing just beyond the copied array." << endl;

   free ( ArrayPtr );

   cout << "Note that the exact addresses returned will vary\n"
        << "with the memory allocation in individual computers."
        << endl;
}

Przykład danych wyjściowych.

The initialized Array contains 4 elements: 10 20 30 40
Address of position after the last element in the array is: 0012FED8
The iterator returned by uninitialized_copy addresses: 00311B88
The address just beyond the last copied element is: 00311B88
The return value is an iterator not pointing just beyond the original array.
The return value is an iterator pointing just beyond the copied array.
Note that the exact addresses returned will vary
with  the memory allocation in individual computers.

Wymagania

Nagłówek: <memory>

Obszar nazw: std