swap_ranges

Článek
06/09/2015

Výměny prvky z jedné oblasti s rozsahem prvků jiného stejné velikosti.

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

Parametry

_First1
Přední iterátor ukazující na první pozici první oblast, jejíž prvky jsou k výměně.
_Last1
Přední iterátor ukazující na jednu za konečné postavení první oblast, jejíž prvky jsou k výměně.
_First2
Přední iterátor ukazující na první místo ve druhé oblasti, jejíž prvky jsou k výměně.

Vrácená hodnota

Přední iterátor ukazující na jednu za konečné postavení ve druhé oblasti, jejíž prvky jsou k výměně.

Poznámky

Odkazované oblasti musí být platná. všechny ukazatele musí být dereferenceable a v rámci každé řady je dostupná z první na poslední pozici ve incrementation.Druhá oblast musí být stejně velká jako první oblast.

Složitost je lineární s _Last1 - _First1 swapy prováděny.Pokud prvky z nádob stejného typu jsou právě vyměnit, je swap členské funkce kontejneru, v němž by měl použít, protože má členská funkce obvykle konstantní složitost.

Příklad

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

Požadavky

Záhlaví: <algoritmus>

Obor názvů: std

Viz také

Referenční dokumentace

Standardní knihovna šablon

Sdílet prostřednictvím