merge

[アーティクル]
03/27/2013

命令の条件にバイナリ述語によって指定される単一の、並べ替えられた先の範囲に 2 個の並べ替えられたソース範囲内からすべての要素を結合します。

template<class InputIterator1, class InputIterator2, class OutputIterator>
   OutputIterator merge(
      InputIterator1 _First1, 
      InputIterator1 _Last1,
      InputIterator2 _First2, 
      InputIterator2 _Last2, 
      OutputIterator _Result
   );
template<class InputIterator1, class InputIterator2, class OutputIterator, class BinaryPredicate>
   OutputIterator merge(
      InputIterator1 _First1, 
      InputIterator1 _Last1,
      InputIterator2 _First2, 
      InputIterator2 _Last2, 
      OutputIterator _Result
      BinaryPredicate _Comp
   );

パラメーター

_First1
2 の狭いの最初の要素の位置を示す入力反復子は、単一の範囲に結合したり、並べ替えられたソース範囲内の並べ替えしました。
_Last1
2 の狭いの最後の要素 1 を超える位置を示す入力反復子は、単一の範囲に結合したり、並べ替えられたソース範囲内の並べ替えしました。
_First2
単一のスコープに結合され、並べ替えられる 2 個の連続する分類されたソース範囲内の 2 番目の先頭の要素の位置を示す入力反復子。
_Last2
単一のスコープに結合され、並べ替えられる 2 個の連続する分類されたソース範囲内の 2 番目の最後の要素 1 を超える位置を示す入力反復子。
_Result
2 個以上のソース範囲内の単一の並べ替えられた範囲に結合する先の範囲の先頭の要素の位置を示す出力反復子。
_Comp
要素が他方の値より大きいか意味を定義するユーザー定義の述語関数オブジェクト。バイナリ述語は最初の要素と 2 個の引数を受け取り、別の方法で 2 番目の要素と false 未満の true を返す必要があります。

戻り値

並べ替えられた先の範囲の最後の要素の一つ前の位置 1 を示す出力反復子。

解説

参照される分類されたソース範囲内で有効である必要があります; すべてのポインターが dereferenceable、各シーケンス内で最後の位置は incrementation によって最初から到達できる必要があります。

先の範囲はソース範囲内の重複し、描画先の範囲を格納するのに十分な大きさが必要です。

並べ替えられたソース範囲内で同じ順序変更するに従って結合された範囲の並べ替えにアルゴリズムによって使用されるのは、にそれぞれと merge アルゴリズムのアプリケーションへの事前条件配置する必要があります。

操作は、各スコープ内の要素の相対位置がディレクティブ先の範囲で保持されるため、安定しています。ソース範囲内では、アルゴリズム mergeによって変更されません。

入力反復子の値の型は、そのほか未満であること (という意味でいずれも他より小さくない) 等しいことが、2 個の要素は、いずれかの決定される命令に対応する小さいある必要があります。これは、不一致要素間の順序で発生します。両方のソース範囲内に対応する要素がある場合、最初の範囲の要素は先の範囲の、二つ目のソースの範囲の要素を記述します。

アルゴリズムの複雑性 (_Last1 – _First1) – (_Last2 – _First2) – 1 の比較と最大で直線的です。

[リスト] のクラスは 2 種類のリストの要素をマージするメンバー関数マージを提供します。

merge 2 に関連する二つの形式があります:

checked_merge

unchecked_merge

ついては、これらの関数がどのようにするか、チェックを行う反復子を参照してください。

使用例

// alg_merge.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <functional>   // For greater<int>( )
#include <iostream>

// Return whether modulus of elem1 is less than modulus of elem2
bool mod_lesser ( int elem1, int elem2 ) {
   if (elem1 < 0) 
      elem1 = - elem1;
   if (elem2 < 0) 
      elem2 = - elem2;
   return elem1 < elem2;
}

int main() {
   using namespace std;
   vector <int> v1a, v1b, v1 ( 12 );
   vector <int>::iterator Iter1a,  Iter1b, Iter1;

   // Constructing vector v1a and v1b with default less than ordering
   int i;
   for ( i = 0 ; i <= 5 ; i++ )
      v1a.push_back(  i );

   int ii;
   for ( ii =-5 ; ii <= 0 ; ii++ )
      v1b.push_back(  ii  );

   cout << "Original vector v1a with range sorted by the\n "
        << "binary predicate less than is  v1a = ( " ;
   for ( Iter1a = v1a.begin( ) ; Iter1a != v1a.end( ) ; Iter1a++ )
      cout << *Iter1a << " ";
   cout << ")." << endl;

   cout << "Original vector v1b with range sorted by the\n "
        << "binary predicate less than is  v1b = ( " ;
   for ( Iter1b = v1b.begin ( ) ; Iter1b != v1b.end ( ) ; Iter1b++ )
      cout << *Iter1b << " ";
   cout << ")." << endl;
   
   // Constructing vector v2 with ranges sorted by greater
   vector <int> v2a ( v1a ) , v2b ( v1b ) ,  v2 ( v1 );
   vector <int>::iterator Iter2a,  Iter2b, Iter2;
   sort ( v2a.begin ( ) , v2a.end ( ) , greater<int> ( ) );
   sort ( v2b.begin ( ) , v2b.end ( ) , greater<int> ( ) );

   cout << "Original vector v2a with range sorted by the\n "
        <<  "binary predicate greater is   v2a =  ( " ;
   for ( Iter2a = v2a.begin ( ) ; Iter2a != v2a.end ( ) ; Iter2a++ )
      cout << *Iter2a << " ";
   cout << ")." << endl;

   cout << "Original vector v2b with range sorted by the\n "
        <<  "binary predicate greater is   v2b =  ( " ;
   for ( Iter2b = v2b.begin ( ) ; Iter2b != v2b.end ( ) ; Iter2b++ )
      cout << *Iter2b << " ";
   cout << ")." << endl;

   // Constructing vector v3 with ranges sorted by mod_lesser
   vector <int> v3a ( v1a ), v3b ( v1b ) ,  v3 ( v1 );
   vector <int>::iterator Iter3a,  Iter3b, Iter3;
   sort ( v3a.begin ( ) , v3a.end ( ) , mod_lesser );
   sort ( v3b.begin ( ) , v3b.end ( ) , mod_lesser );

   cout << "Original vector v3a with range sorted by the\n "
        << "binary predicate mod_lesser is   v3a =  ( " ;
   for ( Iter3a = v3a.begin ( ) ; Iter3a != v3a.end ( ) ; Iter3a++ )
      cout << *Iter3a << " ";
   cout << ")." << endl;

   cout << "Original vector v3b with range sorted by the\n "
        << "binary predicate mod_lesser is   v3b =  ( " ;
   for ( Iter3b = v3b.begin ( ) ; Iter3b != v3b.end ( ) ; Iter3b++ )
      cout << *Iter3b << " ";
   cout << ")." << endl;

   // To merge inplace in ascending order with default binary 
   // predicate less <int> ( )
   merge ( v1a.begin ( ) , v1a.end ( ) , v1b.begin ( ) , v1b.end ( ) , v1.begin ( ) );
   cout << "Merged inplace with default order,\n vector v1mod =  ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")." << endl;

   // To merge inplace in descending order, specify binary 
   // predicate greater<int>( )
   merge ( v2a.begin ( ) , v2a.end ( ) , v2b.begin ( ) , v2b.end ( ) ,
       v2.begin ( ) ,  greater <int> ( ) );
   cout << "Merged inplace with binary predicate greater specified,\n "
        << "vector v2mod  = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")." << endl;

   // Applying A user-defined (UD) binary predicate mod_lesser
   merge ( v3a.begin ( ) , v3a.end ( ) , v3b.begin ( ) , v3b.end ( ) ,
       v3.begin ( ) ,  mod_lesser );
   cout << "Merged inplace with binary predicate mod_lesser specified,\n "
        << "vector v3mod  = ( " ; ;
   for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ )
      cout << *Iter3 << " ";
   cout << ")." << endl;
}

出力

Original vector v1a with range sorted by the
 binary predicate less than is  v1a = ( 0 1 2 3 4 5 ).
Original vector v1b with range sorted by the
 binary predicate less than is  v1b = ( -5 -4 -3 -2 -1 0 ).
Original vector v2a with range sorted by the
 binary predicate greater is   v2a =  ( 5 4 3 2 1 0 ).
Original vector v2b with range sorted by the
 binary predicate greater is   v2b =  ( 0 -1 -2 -3 -4 -5 ).
Original vector v3a with range sorted by the
 binary predicate mod_lesser is   v3a =  ( 0 1 2 3 4 5 ).
Original vector v3b with range sorted by the
 binary predicate mod_lesser is   v3b =  ( 0 -1 -2 -3 -4 -5 ).
Merged inplace with default order,
 vector v1mod =  ( -5 -4 -3 -2 -1 0 0 1 2 3 4 5 ).
Merged inplace with binary predicate greater specified,
 vector v2mod  = ( 5 4 3 2 1 0 0 -1 -2 -3 -4 -5 ).
Merged inplace with binary predicate mod_lesser specified,
 vector v3mod  = ( 0 0 1 -1 2 -2 3 -3 4 -4 5 -5 ).

必要条件

ヘッダー: <algorithm>

名前空間: std

次の方法で共有

merge

パラメーター

戻り値

解説

使用例

出力

必要条件

参照

関連項目

その他のリソース