copy
Przypisuje wartości elementów z zakresu źródłowego zakres docelowy, iteracja źródła sekwencja elementów i przypisywanie im nowych stanowisk w kierunku do przodu.
template<class InputIterator, class OutputIterator>
OutputIterator copy(
InputIterator _First,
InputIterator _Last,
OutputIterator _DestBeg
);
Parametry
_First
Wejściowy iteratora adresowania położenie pierwszego elementu w zakresie źródłowym._Last
Wejściowy iteratora adresowania stanowisko, będący w przeszłości końcowy element w zakresie źródłowym._DestBeg
Iterację wyjścia adresowania położenie pierwszego elementu w zakresie docelowym.
Wartość zwracana
Iterację wyjścia adresowania pozycji jest jeden w przeszłości końcowy element w zakresie docelowym, czyli, adresy iteratora _Result + (_Last — _First ).
Uwagi
Zakres źródłowy musi być ważne i miejsca przeznaczenia, aby pomieścić wszystkie elementy kopiowane musi być wystarczająca ilość miejsca.
Ponieważ algorytm kopiuje elementy źródła w kolejności począwszy od pierwszego elementu, zakres docelowy może pokrywać się z zakresu źródłowego pod warunkiem _Last stanowisko zakres źródłowy nie jest zawarty w zakresie docelowym.Kopiuj umożliwia przesunięcie elementów do lewej, ale nie prawo, chyba, że nie nakładania się zakresów źródłowych i docelowych.Przesunięcie w prawo dowolną liczbę pozycji, użyj copy_backward algorytm.
Kopię algorytm modyfikuje tylko wartości wskazywanej przez Iteratory, przypisywanie do elementów w zakresie docelowym nowych wartości.To nie można używać do tworzenia nowych elementów i nie można bezpośrednio wstawiać elementy do pusty kontener.
copyma dwa powiązane formularze:
Informacji na temat zachowania tych funkcji, zobacz Iteratory zaznaczone.
Przykład
// 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;
}
Przedstawiająca sposób używania kopii innej próbki, zobacz accumulate, copy, i vector::push_back.
Dane wyjściowe
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 )
Wymagania
Nagłówek: <algorithm>
Obszar nazw: std