copy

Artigo
06/09/2015

Atribui os valores dos elementos de um intervalo de origem para um intervalo de destino, para iteração pela sequência de origem dos elementos e atribuindo as novas posições em direção para frente.

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

Parâmetros

_First
Um iterador de entrada que trata a posição do primeiro elemento no intervalo de origem.
_Last
Um iterador de entrada que trata a posição que é uma depois do elemento final no intervalo de origem.
_DestBeg
Um iterador de saída que trata a posição do primeiro elemento no intervalo de destino.

Valor de retorno

Um iterador de saída que trata a posição que é uma depois do elemento final no intervalo de destino, isto é, o iterador aborda _Result + (_Last – _First ).

Comentários

O intervalo de origem deve ser válido e deve haver espaço suficiente no destino para conter todos os elementos que estão sendo copiados.

Como o algoritmo copia os elementos de origem no início da ordem com o primeiro elemento, o intervalo de destino pode sobrepor o intervalo de origem forneceu a posição de _Last do intervalo de origem não estiver no intervalo de destino. copy pode ser usado para deslocar elementos à esquerda mas não à direita, a menos que não há nenhuma sobreposição entre origem e os intervalos de destino. Para mudar à direita qualquer número de posições, use o algoritmo de copy_backward .

O algoritmo de copy altera somente os valores apontados pelos iteradores, atribua novos valores em elementos no intervalo de destino. Não pode ser usado para criar novos elementos e não pode inserir os elementos diretamente em um contêiner vazio.

copy tem dois formulários relacionados:

Para obter informações sobre como essas funções se comportam, consulte Iteradores Verificados.

Exemplo

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

Para outra exemplo de como usar a cópia, consulte accumulate, copy e vector::push_back.

Saída

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 )

Requisitos

Cabeçalho: <algoritmo>

Namespace: std

Consulte também

Referência

Biblioteca de Modelos Padrão

Compartilhar via