std::set_symmetric_difference

ヘッダー `<algorithm>` で定義
template< class InputIt1, class InputIt2, class OutputIt > OutputIt set_symmetric_difference ( InputIt1 first1, InputIt1 last1, InputIt2 first2, InputIt2 last2, OutputIt d_first );	(1)	(C++20 以降 constexpr)
template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2, class ForwardIt3 > ForwardIt3 set_symmetric_difference ( ExecutionPolicy&& policy, ForwardIt1 first1, ForwardIt1 last1, ForwardIt2 first2, ForwardIt2 last2, ForwardIt3 d_first );	(2)	(C++17以降)
template< class InputIt1, class InputIt2, class OutputIt, class Compare > OutputIt set_symmetric_difference ( InputIt1 first1, InputIt1 last1, InputIt2 first2, InputIt2 last2, OutputIt d_first, Compare comp );	(3)	(C++20 以降 constexpr)
template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2, class ForwardIt3, class Compare > ForwardIt3 set_symmetric_difference ( ExecutionPolicy&& policy, ForwardIt1 first1, ForwardIt1 last1, ForwardIt2 first2, ForwardIt2 last2, ForwardIt3 d_first, Compare comp );	(4)	(C++17以降)

2つのソート済み範囲の対称差を計算します。いずれか一方の範囲にのみ存在する要素が、d_first が指す範囲の先頭にコピーされます。出力範囲もソートされます。

[first1, last1) が互いに同等な要素を m 個含み、[first2, last2) がそれらと同等な要素を n 個含む場合、それらの要素のうち std::abs(m - n) 個が、順序を保ったまま出力範囲にコピーされます。

もし m > n なら、m - n 個の要素が [first1, last1) の末尾からコピーされます。
もし m < n なら、n - m 個の要素が [first2, last2) の末尾からコピーされます。

1) もし [first1, last1) または [first2, last2) がソート済みでない場合、動作は未定義となります（operator<(until C++20)std::less{}(since C++20) と比較して）。

3) もし [first1, last1) または [first2, last2) が comp に関してソートされていない場合、動作は未定義です。

2,4) (1,3)と同じだが、policyに従って実行される。

これらのオーバーロードは、以下のすべての条件が満たされた場合にのみオーバーロード解決に参加する。

std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> が true である。	(C++20まで)
std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> は true です。	(C++20以降)

出力範囲が [first1, last1) または [first2, last2) と重複する場合、動作は未定義です。

first1, last1	-	ソート済みの最初の要素の範囲を定義するイテレータのペア
first2, last2	-	ソート済みの2番目の要素の範囲を定義するイテレータのペア
d_first	-	出力範囲の開始位置
policy	-	使用する実行ポリシー
comp	-	比較関数オブジェクト（つまり、Compare の要件を満たすオブジェクト）。最初の引数が2番目の引数より小さい（つまり、前に順序付けられる）場合に true を返します。比較関数のシグネチャは、以下と同等でなければならない。 bool cmp(const Type1& a, const Type2& b); シグネチャは const& を持つ必要はありませんが、関数は渡されたオブジェクトを変更してはならず、値カテゴリに関係なく、(おそらく const の) `Type1` と `Type2` のすべての値を受け入れられる必要があります (したがって、`Type1&` は許可されません。また、`Type1` のムーブがコピーと同等でない限り、`Type1` も許可されません(C++11以降))。 Type1 および Type2 は、InputIt1 および InputIt2 のオブジェクトが間接参照された後、両方の Type1 および Type2 に暗黙的に変換可能でなければなりません。
型要件
- `InputIt1, InputIt2` は LegacyInputIterator の要件を満たす必要がある。
- `OutputIt` は LegacyOutputIterator の要件を満たさなければなりません。
- `ForwardIt1, ForwardIt2, ForwardIt3` は LegacyForwardIterator の要件を満たしている必要があります。
- `Compare`はCompareの要件を満たす必要がある。

[編集] 戻り値

構築された範囲の終了位置の次を指すイテレータ。

[編集] 計算量

std::distance(first1, last1) を $\scriptsize N_1$ $N 1$ とし、std::distance(first2, last2) を $\scriptsize N_2$ $N 2$ とする。

1,2)

2\cdot(N 1 +N 2)-1

回以下の比較 (operator<(until C++20)std::less{}(since C++20)).

3,4) 比較関数 comp の適用は

2\cdot(N 1 +N 2)-1

回以下。

[編集] 例外

ExecutionPolicy というテンプレートパラメータを持つオーバーロードは、次のようにエラーを報告します。

アルゴリズムの一部として呼び出された関数の実行が例外をスローし、ExecutionPolicy が標準ポリシーのいずれかである場合、std::terminate が呼び出されます。その他の ExecutionPolicy の場合、動作は実装定義です。
アルゴリズムがメモリの割り当てに失敗した場合、std::bad_alloc がスローされます。

[編集] 実装例

set_symmetric_difference (1)

template<class InputIt1, class InputIt2, class OutputIt>
OutputIt set_symmetric_difference(InputIt1 first1, InputIt1 last1,
                                  InputIt2 first2, InputIt2 last2, OutputIt d_first)
{
    while (first1 != last1)
    {
        if (first2 == last2)
            return std::copy(first1, last1, d_first);
 
        if (*first1 < *first2)
            *d_first++ = *first1++;
        else
        {
            if (*first2 < *first1)
                *d_first++ = *first2;
            else
                ++first1;
            ++first2;
        }
    }
    return std::copy(first2, last2, d_first);
}

set_symmetric_difference (3)

template<class InputIt1, class InputIt2, class OutputIt, class Compare>
OutputIt set_symmetric_difference(InputIt1 first1, InputIt1 last1,
                                  InputIt2 first2, InputIt2 last2,
                                  OutputIt d_first, Compare comp)
{
    while (first1 != last1)
    {
        if (first2 == last2)
            return std::copy(first1, last1, d_first);
 
        if (comp(*first1, *first2))
            *d_first++ = *first1++;
        else
        {
            if (comp(*first2, *first1))
                *d_first++ = *first2;
            else
                ++first1;
            ++first2;
        }
    }
    return std::copy(first2, last2, d_first);
}

[編集] 例

このコードを実行

#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
 
int main()
{
    std::vector<int> v1{1, 2, 3, 4, 5, 6, 7, 8};
    std::vector<int> v2{5, 7, 9, 10};
    std::sort(v1.begin(), v1.end());
    std::sort(v2.begin(), v2.end());
 
    std::vector<int> v_symDifference;
 
    std::set_symmetric_difference(v1.begin(), v1.end(), v2.begin(), v2.end(),
                                  std::back_inserter(v_symDifference));
 
    for (int n : v_symDifference)
        std::cout << n << ' ';
    std::cout << '\n';
}

出力

1 2 3 4 6 8 9 10

[編集] 不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 291	C++98	入力範囲における等価な要素の扱いが未指定でした。	指定された

[編集] 関連項目

includes	あるシーケンスが別のシーケンスの部分シーケンスである場合に true を返す (関数テンプレート) [編集]
set_difference	2つの集合の差を計算する (関数テンプレート) [編集]
set_union	2つの集合の和を計算する (関数テンプレート) [編集]
set_intersection	2つの集合の積を計算する (関数テンプレート) [編集]
ranges::set_symmetric_difference (C++20)	2つの集合の対称差を計算する (アルゴリズム関数オブジェクト)[編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作