swap_ranges

Artigo
06/09/2015

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

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

Parâmetros

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

Valor de retorno

Um iterador para que aponte para um após a posição final do intervalo cujos elementos devem ser trocadas.

Comentários

Os intervalos referenciados devem ser válidos; todos os ponteiros devem ser dereferenceable e dentro de cada sequência última posição da primeira é possível acessá-lo pela incrementação. O intervalo precisa ser tão grande quanto o primeiro intervalo.

A complexidade é linear com _Last1 – a troca de_First1 executadas. Se os elementos dos contêineres do mesmo tipo estão sendo alternado, a função de membro de swap desse contêiner devem ser usados, porque a função de membro tem normalmente 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: <algoritmo>

Namespace: std

Consulte também

Referência

Biblioteca de Modelos Padrão

Partilhar via