std::ranges::unique
| ヘッダ <algorithm>
|
||
| で定義 |
||
template< std::permutable I, std::sentinel_for<I> S, class Proj = std::identity,
std::indirect_equivalence_relation<std::projected<I, Proj>>
C = ranges::equal_to >
constexpr ranges::subrange<I>
unique( I first, S last, C comp = {}, Proj proj = {} );
|
(1) | (C++20 以降) |
template< ranges::forward_range R, class Proj = std::identity,
std::indirect_equivalence_relation<std::projected<ranges::iterator_t<R>, Proj>>
C = ranges::equal_to >
requires std::permutable<ranges::iterator_t<R>>
constexpr ranges::borrowed_subrange_t<R>
unique( R&& r, C comp = {}, Proj proj = {} );
|
(2) | (C++20 以降) |
[first, last) から、等価な要素の連続するグループごとに最初の要素以外をすべて削除し、部分範囲 [ret, last) を返します。ここで ret は範囲の新しい終端を指す終端イテレータです。*(i - 1) と *i は、std::invoke(comp, std::invoke(proj, *(i - 1)), std::invoke(proj, *i)) == true の場合に等価とみなされます。ここで i は範囲 [first + 1, last) 内のイテレータです。r を使用します。これは ranges::begin(r) を first として、ranges::end(r) を last として使用するのと同様です。このページで説明されている関数のようなエンティティは アルゴリズム関数オブジェクト です (非公式に niebloid として知られています)。すなわち:
- それらのいずれかを呼び出すときに明示的なテンプレート実引数リストを指定することはできません。
- それらはいずれも 引数依存の名前検索 では可視ではありません。
- それらのいずれかが関数呼び出し演算子の左側の名前として 通常の非修飾名前検索 によって発見された場合、引数依存の名前検索 は抑制されます。
パラメータ
| first, last | - | 処理する要素の 範囲 を定義するイテレータ-センチネルペア |
| r | - | 処理する要素の範囲 |
| comp | - | 投影された要素を比較する二項述語 |
| proj | - | 要素に適用する投影 |
戻り値
戻り値は
{
ret, last
}
で、
ret
は範囲の新しい終端を指すpast-the-endイテレータです。
計算量
空でない範囲の場合、対応する述語 comp の適用は正確に ranges:: distance ( first, last ) - 1 回であり、任意の射影 proj の適用はその2倍を超えない。
注記
削除は、範囲内の要素を移動代入によってシフトすることで行われ、削除されない要素が範囲の先頭に現れるようにします。残る要素の相対的な順序は保持され、コンテナの
物理的な
サイズは変更されません。
[
ret
,
last
)
内のイテレータ（存在する場合）は依然としてデリファレンス可能ですが、要素自体は未規定の値を持ちます（
MoveAssignable
の事後条件に従います）。
ranges::uniqueへの呼び出しは、時としてコンテナの
erase
メンバ関数の呼び出しに続けられます。これにより未規定の値が削除され、コンテナの
物理的
サイズが新しい
論理的
サイズに合うように縮小されます。これら2つの呼び出しを組み合わせることで、
Erase–remove
イディオム
を実現します。
実装例
struct unique_fn { template<std::permutable I, std::sentinel_for<I> S, class Proj = std::identity, std::indirect_equivalence_relation<std::projected<I, Proj>> C = ranges::equal_to> constexpr ranges::subrange<I> operator()(I first, S last, C comp = {}, Proj proj = {}) const { first = ranges::adjacent_find(first, last, comp, proj); if (first == last) return {first, first}; auto i {first}; ++first; while (++first != last) if (!std::invoke(comp, std::invoke(proj, *i), std::invoke(proj, *first))) *++i = ranges::iter_move(first); return {++i, first}; } template<ranges::forward_range R, class Proj = std::identity, std::indirect_equivalence_relation<std::projected<ranges::iterator_t<R>, Proj>> C = ranges::equal_to> requires std::permutable<ranges::iterator_t<R>> constexpr ranges::borrowed_subrange_t<R> operator()(R&& r, C comp = {}, Proj proj = {}) const { return (*this)(ranges::begin(r), ranges::end(r), std::move(comp), std::move(proj)); } }; inline constexpr unique_fn unique {}; |
例
#include <algorithm> #include <cmath> #include <complex> #include <iostream> #include <vector> struct id { int i; explicit id(int i) : i {i} {} }; void print(id i, const auto& v) { std::cout << i.i << ") "; std::ranges::for_each(v, [](auto const& e) { std::cout << e << ' '; }); std::cout << '\n'; } int main() { // 重複要素を含むベクトル std::vector<int> v {1, 2, 1, 1, 3, 3, 3, 4, 5, 4}; print(id {1}, v); // 連続する重複要素を削除 const auto ret = std::ranges::unique(v); // vは現在 {1 2 1 3 4 5 4 x x x} を保持（'x'は不定値） v.erase(ret.begin(), ret.end()); print(id {2}, v); // ソート後にuniqueを適用して全ての重複を削除 std::ranges::sort(v); // {1 1 2 3 4 4 5} print(id {3}, v); const auto [first, last] = std::ranges::unique(v.begin(), v.end()); // vは現在 {1 2 3 4 5 x x} を保持（'x'は不定値） v.erase(first, last); print(id {4}, v); // カスタム比較と射影を用いたunique std::vector<std::complex<int>> vc { {1, 1}, {-1, 2}, {-2, 3}, {2, 4}, {-3, 5} }; print(id {5}, vc); const auto ret2 = std::ranges::unique(vc, // 実部の絶対値が等しい場合に複素数を等価とみなす： [](int x, int y) { return std::abs(x) == std::abs(y); }, // comp [](std::complex<int> z) { return z.real(); } // proj ); vc.erase(ret2.begin(), ret2.end()); print(id {6}, vc); }
出力：
1) 1 2 1 1 3 3 3 4 5 4 2) 1 2 1 3 4 5 4 3) 1 1 2 3 4 4 5 4) 1 2 3 4 5 5) (1,1) (-1,2) (-2,3) (2,4) (-3,5) 6) (1,1) (-2,3) (-3,5)
関連項目
|
(C++20)
|
連続する重複を含まない要素の範囲のコピーを作成する
(アルゴリズム関数オブジェクト) |
|
(C++20)
|
等しい（または与えられた述語を満たす）最初の2つの隣接する要素を検索する
(アルゴリズム関数オブジェクト) |
|
(C++20)
(C++20)
|
特定の条件を満たす要素を削除する
(アルゴリズム関数オブジェクト) |
|
範囲内の連続する重複要素を削除する
(関数テンプレート) |
|
|
連続する重複要素を削除する
( std::list<T,Allocator>の公開メンバ関数)
|
|
|
連続する重複要素を削除する
( std::forward_list<T,Allocator>の公開メンバ関数)
|