set_difference
1 種類の並べ替えられたソース範囲内に属するが、2 番目の手順の条件にバイナリ述語によって指定される可能性もある、一つの並べ替えられた先の範囲はソース範囲内、分類される要素すべてを結合します。
template<class InputIterator1, class InputIterator2, class OutputIterator>
OutputIterator set_difference(
InputIterator1 first1,
InputIterator1 last1,
InputIterator2 first2,
InputIterator2 last2,
OutputIterator result
);
template<class InputIterator1, class InputIterator2, class OutputIterator, class BinaryPredicate>
OutputIterator set_difference(
InputIterator1 first1,
InputIterator1 last1,
InputIterator2 first2,
InputIterator2 last2,
OutputIterator result,
BinaryPredicate comp
);
パラメーター
first1
2 の狭いの最初の要素の位置を示す入力反復子は、2 個以上のソース範囲内の相違点を表す単一の範囲に結合して分類されたソース範囲内の並べ替えしました。last1
2 の狭いの最後の要素 1 を超える位置を示す入力反復子は、2 個以上のソース範囲内の相違点を表す単一の範囲に結合して分類されたソース範囲内の並べ替えしました。first2
2 個以上のソース範囲内の相違点を表す単一の範囲に結合して分類される 2 個の連続する分類されたソース範囲内の 2 番目の先頭の要素の位置を示す入力反復子。last2
2 個以上のソース範囲内の相違点を表す単一の範囲に結合して分類される 2 個の連続する分類されたソース範囲内の 2 番目の最後の要素 1 を超える位置を示す入力反復子。result
2 個以上のソース範囲内に 2 個のソース範囲内の相違点を表す単一の並べ替えられた範囲に結合する先の範囲の先頭の要素の位置を示す出力反復子。comp
要素が他方の値より大きいか意味を定義するユーザー定義の述語関数オブジェクト。バイナリ述語は最初の要素と 2 個の引数を受け取り、別の方法で 2 番目の要素と false 未満の true を返す必要があります。
戻り値
2 個以上のソース範囲内の相違点を表す並べ替えられた先の範囲の最後の要素の一つ前の位置 1 を示す出力反復子。
解説
参照される分類されたソース範囲内で有効である必要があります; すべてのポインターが dereferenceable、各シーケンス内で最後の位置は incrementation によって最初から到達できる必要があります。
先の範囲はソース範囲内の重複すると、最初のソース範囲内を格納するのに十分な大きさが必要です。
並べ替えられたソース範囲内で同じ順序変更するに従って結合された範囲の並べ替えにアルゴリズムによって使用されるのは、にそれぞれと set_difference アルゴリズムのアプリケーションへの事前条件配置する必要があります。
操作は、各スコープ内の要素の相対位置がディレクティブ先の範囲で保持されるため、安定しています。ソース範囲内では、アルゴリズムのマージによって変更されません。
入力反復子の値の型は、そのほか未満であること (という意味でいずれも他より小さくない) 等しいことが、2 個の要素は、いずれかの決定される小さい対応する順序である必要があります。これは、不一致要素間の順序で発生します。両方のソース範囲内に対応する要素がある場合、最初の範囲の要素は先の範囲の、二つ目のソースの範囲の要素を記述します。2 番目のは最初のソース範囲内にあること、ソース範囲内の要素の複製をこのようなに含まれている場合、描画先の範囲は最初のソース範囲内のそれらの要素の生成が二つ目のソースの範囲内の要素の生成を超える数が含まれます。
アルゴリズムの複雑性は、最大で 2 と線形 (* (last1 – first1) – (last2 – first2) ) 空でないソース範囲内の – 1 の比較があります。
set_difference 2 に関連する二つの形式があります:
ついては、これらの関数がどのようにするか、チェックを行う反復子を参照してください。
使用例
// alg_set_diff.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, Result1;
// Constructing vectors v1a & v1b with default less-than ordering
int i;
for ( i = -1 ; i <= 4 ; i++ )
{
v1a.push_back( i );
}
int ii;
for ( ii =-3 ; 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 vectors v2a & v2b with ranges sorted by greater
vector <int> v2a ( v1a ) , v2b ( v1b ) , v2 ( v1 );
vector <int>::iterator Iter2a, Iter2b, Iter2, Result2;
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 vectors v3a & v3b with ranges sorted by mod_lesser
vector <int> v3a ( v1a ), v3b ( v1b ) , v3 ( v1 );
vector <int>::iterator Iter3a, Iter3b, Iter3, Result3;
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 combine into a difference in asscending
// order with the default binary predicate less <int> ( )
Result1 = set_difference ( v1a.begin ( ) , v1a.end ( ) ,
v1b.begin ( ) , v1b.end ( ) , v1.begin ( ) );
cout << "Set_difference of source ranges with default order,"
<< "\n vector v1mod = ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != Result1 ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
// To combine into a difference in descending
// order specify binary predicate greater<int>( )
Result2 = set_difference ( v2a.begin ( ) , v2a.end ( ) ,
v2b.begin ( ) , v2b.end ( ) ,v2.begin ( ) , greater <int> ( ) );
cout << "Set_difference of source ranges with binary"
<< "predicate greater specified,\n vector v2mod = ( " ;
for ( Iter2 = v2.begin( ) ; Iter2 != Result2 ; Iter2++ )
cout << *Iter2 << " ";
cout << ")." << endl;
// To combine into a difference applying a user
// defined binary predicate mod_lesser
Result3 = set_difference ( v3a.begin ( ) , v3a.end ( ) ,
v3b.begin ( ) , v3b.end ( ) , v3.begin ( ) , mod_lesser );
cout << "Set_difference of source ranges with binary "
<< "predicate mod_lesser specified,\n vector v3mod = ( " ; ;
for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ )
cout << *Iter3 << " ";
cout << ")." << endl;
}
出力
Original vector v1a with range sorted by the
binary predicate less than is v1a = ( -1 0 1 2 3 4 ).
Original vector v1b with range sorted by the
binary predicate less than is v1b = ( -3 -2 -1 0 ).
Original vector v2a with range sorted by the
binary predicate greater is v2a = ( 4 3 2 1 0 -1 ).
Original vector v2b with range sorted by the
binary predicate greater is v2b = ( 0 -1 -2 -3 ).
Original vector v3a with range sorted by the
binary predicate mod_lesser is v3a = ( 0 -1 1 2 3 4 ).
Original vector v3b with range sorted by the
binary predicate mod_lesser is v3b = ( 0 -1 -2 -3 ).
Set_difference of source ranges with default order,
vector v1mod = ( 1 2 3 4 ).
Set_difference of source ranges with binarypredicate greater specified,
vector v2mod = ( 4 3 2 1 ).
Set_difference of source ranges with binary predicate mod_lesser specified,
vector v3mod = ( 1 4 ).
必要条件
ヘッダー: <algorithm>
名前空間: std