Поделиться через


копировать

Присвоить значения элементов из диапазона источника в качестве назначения, повторяя через последовательность элементов источника и присвоению ему новые переднем позиции в направлении.

template<class InputIterator, class OutputIterator> 
   OutputIterator copy( 
      InputIterator _First,  
      InputIterator _Last,  
      OutputIterator _DestBeg 
   );

Параметры

  • _First
    Итератор ввода слишком позицию первого элемента в диапазон источника.

  • _Last
    Позиция ввода итератор решить, одно окончательное за элементом в диапазон источника.

  • _DestBeg
    Итератор вывода слишком позицию первого элемента в диапазоне назначения.

Возвращаемое значение

Итератор вывода слишком позиция, одно окончательное за элементом в диапазоне назначения, т е итераторе рассматривается _Result + (_Last — _First ).

Заметки

Диапазон источника должен быть допустимым и должно быть достаточным объемом памяти в назначении для хранения, копированными все элементы.

Поскольку алгоритм копирует элементы источника в начале порядка с первым элементом, диапазон назначения могут перекрываться с диапазоном источника, положение _Last диапазона источника не содержится в диапазоне назначения. copy используется, чтобы сдвигать элементы влево, но не справа, если не станет перекрытия между источником и диапазонами назначения. Чтобы сдвигать вправо любое количество позиций используйте алгоритм copy_backward.

Алгоритм copy изменится только значения, указанные в итераторам присвоению новые значения элементам в диапазоне назначения. Его нельзя использовать для создания новых элементов и не может вставлять элементы в пустой контейнер напрямую.

copy имеет две связанные формы:

Дополнительные сведения о том, как ведут себя эти функции, см. в разделе Проверяемые итераторы.

Пример

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

int main() {
   using namespace std;
   vector <int> v1, v2;
   vector <int>::iterator Iter1, Iter2;

   int i;
   for ( i = 0 ; i <= 5 ; i++ )
      v1.push_back( 10 * i );

   int ii;
   for ( ii = 0 ; ii <= 10 ; ii++ )
      v2.push_back( 3 * ii );

   cout << "v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;

   cout << "v2 = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")" << endl;

   // To copy the first 3 elements of v1 into the middle of v2
   copy( v1.begin( ), v1.begin( ) + 3, v2.begin( ) + 4 );

   cout << "v2 with v1 insert = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")" << endl;

   // To shift the elements inserted into v2 two positions
   // to the left
   copy( v2.begin( )+4, v2.begin( ) + 7, v2.begin( ) + 2 );

   cout << "v2 with shifted insert = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")" << endl;
}

Для отображения другого примера использования копии см. в разделе accumulate, copy и vector::push_back.

  

Output

v1 = ( 0 10 20 30 40 50 )
v2 = ( 0 3 6 9 12 15 18 21 24 27 30 )
v2 with v1 insert = ( 0 3 6 9 0 10 20 21 24 27 30 )
v2 with shifted insert = ( 0 3 0 10 20 10 20 21 24 27 30 )

Требования

Заголовок: <algorithm>

Пространство имен: std

См. также

Ссылки

Библиотека стандартных шаблонов