std::ranges::unique
来自cppreference.com
在标头 <algorithm> 定义 | ||
调用签名 | ||
template<std::permutable I, std::sentinel_for<I> S, class Proj =std::identity, std::indirect_equivalence_relation<std::projected<I, Proj>> | (1) | (C++20 起) |
template<ranges::forward_range R, class Proj =std::identity, std::indirect_equivalence_relation<std::projected<ranges::iterator_t<R>, Proj>> | (2) | (C++20 起) |
1) 消除范围
[first, last) 的每个连续的等价元素组中首个以外的全部元素，并返回子范围 [ret, last)，其中 ret 是新范围的尾后迭代器。 若 std::invoke(comp, std::invoke(proj, *(i -1)), std::invoke(proj, *i))==true 则认为二个连续元素
*(i - 1) 与 *i 等价，其中 i 是范围 [first +1, last) 中的迭代器。此页面上描述的函数式实体是算法函数对象（非正式地称为 niebloid），即：
目录 |
[编辑]参数
| first, last | - | 处理的元素范围的迭代器-哨位对 |
| r | - | 要处理的元素范围 |
| comp | - | 比较投影后元素的二元谓词 |
| proj | - | 应用到元素的投影 |
[编辑]返回值
返回 {ret, last}，其中 ret 是新范围末尾的尾后迭代器。
[编辑]复杂度
对于非空范围，准确应用相应的谓词 compranges::distance(first, last)-1 次，并且应用投影 proj 的次数不多于其二倍。
[编辑]注解
由迁移（通过移动赋值的手段）范围中的元素进行移除，使得未被移除的元素出现在范围起始。保持元素的相对顺序并且不改变容器的物理大小。[ret, last) 中的迭代器（若存在）仍然可解引用，但元素自身拥有未指定值（如可移动赋值(MoveAssignable) 后条件所要求）。
对 ranges::unique 的调用有时后随容器的 erase 成员函数，这擦除未指定值并减少容器的物理大小以匹配其新的逻辑大小。此二调用一并实现擦除-移除手法。
[编辑]可能的实现
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>constexprranges::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>>constexprranges::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));}}; inlineconstexpr 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, constauto& v){std::cout<< i.i<<") "; std::ranges::for_each(v, [](autoconst& e){std::cout<< e <<' ';});std::cout<<'\n';} int main(){// 含数个重复元素的 vectorstd::vector<int> v{1, 2, 1, 1, 3, 3, 3, 4, 5, 4}; print(id {1}, v); // 移除连续（相接）的副本constauto 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); // sort 后随 unique，移除所有副本 std::ranges::sort(v);// {1 1 2 3 4 4 5} print(id {3}, v); constauto[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); // 以定制比较与投影 uniquestd::vector<std::complex<int>> vc{{1, 1}, {-1, 2}, {-2, 3}, {2, 4}, {-3, 5}}; print(id {5}, vc); constauto 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) | 查找首对相同（或满足给定谓词）的相邻元素 (算法函数对象) |
(C++20)(C++20) | 移除满足特定条件的元素 (算法函数对象) |
| 移除范围中连续重复元素 (函数模板) | |
| 删除连续的重复元素 ( std::list<T,Allocator> 的公开成员函数) | |
| 删除连续的重复元素 ( std::forward_list<T,Allocator> 的公开成员函数) |
