std::ranges::unique_copy, std::ranges::unique_copy_result

来自cppreference.com
< cpp‎ | algorithm‎ | ranges
 
 
算法库
受约束算法及范围上的算法(C++20)
包含算法例如 ranges::copy, ranges::sort, ...
执行策略 (C++17)
排序和相关操作
划分操作
排序操作
二分搜索操作(在已划分范围上)
集合操作(在有序范围上)
归并操作(在有序范围上)
堆操作
最小/最大操作
(C++11)
(C++17)
字典序比较操作
排列操作
C 库

数值运算
(C++11)                       
在未初始化内存上的操作
 
受约束算法
本菜单中的所有名字均属于命名空间 std::ranges
不修改序列的操作
修改序列的操作
划分操作
排序操作
二分搜索操作(在有序范围上)
       
       
集合操作(在有序范围上)
堆操作
最小/最大操作
排列操作
折叠操作
数值操作
(C++23)            
未初始化存储上的操作
返回类型
 
在标头 <algorithm> 定义
调用签名
template<std::input_iterator I, std::sentinel_for<I> S, std::weakly_incrementable O,

          class Proj =std::identity,
          std::indirect_equivalence_relation<std::projected<I, Proj>>
              C =ranges::equal_to>
requires std::indirectly_copyable<I, O>&&(std::forward_iterator<I>||
             (std::input_iterator<O>&&std::same_as<std::iter_value_t<I>,
                 std::iter_value_t<O>>)||std::indirectly_copyable_storable<I, O>)
constexpr unique_copy_result<I, O>

    unique_copy( I first, S last, O result, C comp ={}, Proj proj ={});
(1) (C++20 起)
template<ranges::input_range R, std::weakly_incrementable O,

          class Proj =std::identity,
          std::indirect_equivalence_relation<std::projected<ranges::iterator_t<R>,
              Proj>> C =ranges::equal_to>
requires std::indirectly_copyable<ranges::iterator_t<R>, O>&&
             (std::forward_iterator<ranges::iterator_t<R>>||
             (std::input_iterator<O>&&std::same_as<ranges::range_value_t<R>,
                 std::iter_value_t<O>>)||
             std::indirectly_copyable_storable<ranges::iterator_t<R>, O>)
constexpr unique_copy_result<ranges::borrowed_iterator_t<R>, O>

    unique_copy( R&& r, O result, C comp ={}, Proj proj ={});
(2) (C++20 起)
辅助类型
template<class I, class O >
using unique_copy_result =ranges::in_out_result<I, O>;
(3) (C++20 起)
1) 从源范围 [firstlast) 复制元素到始于 result 的目标范围,使得无连续的元素比较相等。只复制每群相等元素中的第一个。
范围 [firstlast)[resultresult + N) 必须不重叠。N =ranges::distance(first, last)
std::invoke(comp, std::invoke(proj, *(i -1)), std::invoke(proj, *i))==true,其中 i 为范围 [first +1last) 中的迭代器,则认为两个连续元素 *(i -1)*i 比较相等。
2)(1),但以 r 为源范围,如同以 ranges::begin(r)first 并以 ranges::end(r)last

此页面上描述的函数式实体是算法函数对象(非正式地称为 niebloid),即:

目录

[编辑]参数

first, last - 要处理的源元素范围的迭代器-哨位对
r - 要处理的源元素范围
result - 目标元素范围
comp - 比较投影后元素的谓词
proj - 应用到谓词的投影

[编辑]返回值

{last, result + N}

[编辑]复杂度

准确应用对应的谓词 compN -1 次,并应用投影 proj 的次数不多于其二倍。

[编辑]可能的实现

参阅 libstdc++MSVC STL(及第三方库: cmcstl2NanoRangerange-v3)中的实现。

struct unique_copy_fn {template<std::input_iterator I, std::sentinel_for<I> S, std::weakly_incrementable O, class Proj =std::identity, std::indirect_equivalence_relation<std::projected<I, Proj>> C =ranges::equal_to> requires std::indirectly_copyable<I, O>&&(std::forward_iterator<I>||(std::input_iterator<O>&&std::same_as<std::iter_value_t<I>, std::iter_value_t<O>>)||std::indirectly_copyable_storable<I, O>)constexpr ranges::unique_copy_result<I, O> operator()(I first, S last, O result, C comp ={}, Proj proj ={})const{if(!(first == last)){std::iter_value_t<I> value =*first;*result = value;++result;while(!(++first == last)){auto&& value2 =*first;if(!std::invoke(comp, std::invoke(proj, value2), std::invoke(proj, value))){ value =std::forward<decltype(value2)>(value2);*result = value;++result;}}}   return{std::move(first), std::move(result)};}   template<ranges::input_range R, std::weakly_incrementable O, class Proj =std::identity, std::indirect_equivalence_relation<std::projected<ranges::iterator_t<R>, Proj>> C =ranges::equal_to> requires std::indirectly_copyable<ranges::iterator_t<R>, O>&&(std::forward_iterator<ranges::iterator_t<R>>||(std::input_iterator<O>&&std::same_as<ranges::range_value_t<R>, std::iter_value_t<O>>)||std::indirectly_copyable_storable<ranges::iterator_t<R>, O>)constexpr ranges::unique_copy_result<ranges::borrowed_iterator_t<R>, O> operator()(R&& r, O result, C comp ={}, Proj proj ={})const{return(*this)(ranges::begin(r), ranges::end(r), std::move(result), std::move(comp), std::move(proj));}};   inlineconstexpr unique_copy_fn unique_copy {};

[编辑]示例

#include <algorithm>#include <cmath>#include <iostream>#include <iterator>#include <list>#include <string>#include <type_traits>   void print(constauto& rem, constauto& v){using V =std::remove_cvref_t<decltype(v)>;constexprbool sep{std::is_same_v<typename V::value_type, int>};std::cout<< rem <<std::showpos;for(constauto& e : v)std::cout<< e <<(sep ?" ":"");std::cout<<'\n';}   int main(){std::string s1{"The string with many spaces!"}; print("s1: ", s1);   std::string s2; std::ranges::unique_copy( s1.begin(), s1.end(), std::back_inserter(s2), [](char c1, char c2){return c1 ==' '&& c2 ==' ';}); print("s2: ", s2);   constauto v1 ={-1, +1, +2, -2, -3, +3, -3}; print("v1: ", v1);std::list<int> v2; std::ranges::unique_copy( v1, std::back_inserter(v2), {}, // 默认比较器 std::ranges::equal_to[](int x){return std::abs(x);}// 投影); print("v2: ", v2);}

输出:

s1: The string with many spaces! s2: The string with many spaces! v1: -1 +1 +2 -2 -3 +3 -3 v2: -1 +2 -3

[编辑]参阅

移除范围中连续重复元素
(算法函数对象)[编辑]
复制范围中元素到新位置
(算法函数对象)[编辑]
查找首对相同(或满足给定谓词)的相邻元素
(算法函数对象)[编辑]
创建某范围的不含连续重复元素的副本
(函数模板)[编辑]
close