swap_ranges

Статья
06/09/2015

Меняет местами элементы одного диапазона с элементами других, диапазоном равенства с размером.

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

Параметры

_First1
Передний итератор, указывающего на первой позиции первого диапазона, элементы которого, передаваемых.
_Last1
Передний итератор — одно за конечной позиции первого диапазона, элементы которого, передаваемых.
_First2
Передний итератор, указывающего на первой позиции второго диапазона, элементы которого, передаваемых.

Возвращаемое значение

Передний итератор — одно за конечной позиции второго диапазона, элементы которого, передаваемых.

Заметки

Связанные диапазоны должны быть допустимыми; все указатели должны быть dereferenceable и внутри каждой последовательности последнего положения доступен из первого инкрементацией. Второй набор должен быть как большим как первый диапазон.

Сложность линейная с _Last1 — выполняются обмен _First1. Если обмениваются контейнеров элементов из одного типа, они функцию-член swap из него должен использоваться, поскольку функцию-член обычно имеет постоянно сложности.

Пример

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

Требования

Заголовок: <algorithm>

Пространство имен: std

См. также

Ссылки

Библиотека стандартных шаблонов

Поделиться через