swap_ranges

Artigo
02/24/2013

Troca os elementos de um intervalo com elementos do outro, igual intervalo - dimensionado.

template<class ForwardIterator1, class ForwardIterator2>
   ForwardIterator2 swap_ranges(
      ForwardIterator1 _First1, 
      ForwardIterator1 _Last1,
      ForwardIterator2 _First2
   );

Parâmetros

_First1
Um iterador frente que aponta para a primeira posição do primeiro intervalo cujos elementos devem ser trocada.
_Last1
Um iterador frente que aponta para um após a posição final do primeiro intervalo cujos elementos devem ser trocada.
_First2
Um iterador frente que aponta para a primeira posição do segundo intervalo cujos elementos devem ser trocada.

Valor de retorno

Um iterador frente que aponta para um após a posição final do segundo intervalo cujos elementos devem ser trocada.

Comentários

Os intervalos referenciados deve ser válido; todos os ponteiros devem ser dereferenceable e em cada seqüência a posição da última é alcançável de primeira por incrementação.o segundo intervalo tem que ser tão grande como o primeiro intervalo.

Complexidade é um-a-um com _Last1 – a troca de _First1 executadas.Se os elementos de contêiner do mesmo tipo estão sendo trocados, a função de membro de swap do contêiner devem ser usados, porque a função de membro normalmente tem a complexidade constante.

Exemplo

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

int main( ) 
{
   using namespace std;
   vector <int> v1;
   deque <int> d1;
   vector <int>::iterator v1Iter1;
   deque<int>::iterator d1Iter1;

   int i;
   for ( i = 0 ; i <= 5 ; i++ )
   {
      v1.push_back( i );
   }

   int ii;
   for ( ii =4 ; ii <= 9 ; ii++ )
   {
      d1.push_back( 6 );
   }

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

   cout << "Deque d1 is  ( " ;
   for ( d1Iter1 = d1.begin( ) ; d1Iter1 != d1.end( ) ;d1Iter1 ++ )
      cout << *d1Iter1  << " ";
   cout << ")." << endl;

   swap_ranges ( v1.begin ( ) , v1.end ( ) , d1.begin ( ) );

   cout << "After the swap_range, vector v1 is ( " ;
   for ( v1Iter1 = v1.begin( ) ; v1Iter1 != v1.end( ) ;v1Iter1 ++ )
      cout << *v1Iter1 << " ";
   cout << ")." << endl;

   cout << "After the swap_range deque d1 is   ( " ;
   for ( d1Iter1 = d1.begin( ) ; d1Iter1 != d1.end( ) ;d1Iter1 ++ )
      cout << *d1Iter1 << " ";
   cout << ")." << endl;
}

Requisitos

Cabeçalho: <algorithm>

namespace: STD

Consulte também

Referência

Standard Template Library

Compartilhar via