swap_ranges

切換至某個範圍的項目以其他的項目，這個大小相等的範圍。

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

參數

• _First1
  指向項目要交換第一個範圍的第一個位置的順向 Iterator。

• _Last1
  指向一的順向 Iterator 透過項目要交換第一個範圍的最後位置。

• _First2
  指向項目要交換第二個範圍的第一個位置的順向 Iterator。

傳回值

指向一的順向 Iterator 透過項目要交換第二個範圍中的最後位置。

備註

參考的範圍必須是有效的，任何指標必須 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

請參閱

參考

標準樣板程式庫