copy

Článek
03/26/2013

Přiřadí hodnoty prvků ze zdrojové oblasti cílová oblast iterace zdroj posloupnost prvků a jejich nové pozice ve směru vpřed.

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

Parametry

_First
Vstupní iterační adresování pozici první prvek ve zdrojové oblasti.
_Last
Vstupní iterační adresování pozici, která je jednou za poslední prvek ve zdrojové oblasti.
_DestBeg
Iterace výstup adresování pozici první prvek v cílové oblasti.

Vrácená hodnota

Iterátoru výstupní pozice, která je jednou za poslední prvek v cílové oblasti se adresování, iterace adresy _Result + (_Last – _First ).

Poznámky

Zdrojové oblasti musí být platný a musí být dostatek místa na cílovém držet všechny kopírované prvky.

Protože algoritmus zkopíruje zdrojové prvky v pořadí počínaje prvním prvkem, cílové oblasti mohou překrývat s zdrojové oblasti uvedené _Last pozice zdrojové oblasti není obsažen v cílové oblasti.copy lze použít prvky Posun doleva, ale nikoli právo dokud nedojde k překrývání mezi zdrojové a cílové oblasti.Posunout vpravo libovolný počet pozic, použít copy_backward algoritmus.

Copy algoritmus upravuje pouze hodnoty odkazuje u iterátorů, přiřadíte nové hodnoty prvků v cílové oblasti.Nelze použít k vytvoření nové prvky a nelze vkládat prvky do prázdného kontejneru přímo.

copymá dva související formuláře:

Informace o chování těchto funkcí naleznete v tématu Zaškrtnuté iterátory.

Příklad

// 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;
}

Ukazující způsob použití kopie jiného vzorku, viz accumulate, copy, a vector::push_back.

Výsledek

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 )

Požadavky

Záhlaví: <algorithm>

Obor názvů: std

Viz také

Referenční dokumentace

Standardní šablona knihovny

Sdílet prostřednictvím