命名空间
变体
操作

std::ranges::copy_n, std::ranges::copy_n_result

来自 cppreference.cn
< cpp‎ | 算法‎ | 范围
 
 
算法库
有约束算法与针对范围的算法 (C++20)
有约束的算法,例如 ranges::copyranges::sort 等……
执行策略 (C++17)
排序及相关操作
划分操作
排序操作
二分搜索操作
(于已划分范围上)
集合操作(于已排序范围上)
归并操作(于已排序范围上)
堆操作
最小/最大值操作
(C++11)
(C++17)
字典序比较操作
排列操作
C 库
数值操作
未初始化内存上的操作
 
受约束算法
此菜单中的所有名称均属于命名空间 std::ranges
非修改序列操作
修改序列操作
划分操作
排序操作
二分查找操作(在已排序的范围内)
       
       
集合操作(于已排序范围上)
堆操作
最小/最大值操作
       
       
排列操作
折叠操作
数值操作
(C++23)            
对未初始化存储的操作
返回类型
 
定义于头文件 <algorithm>
调用签名 (Call signature)
template< std::input_iterator I, std::weakly_incrementable O >

requires std::indirectly_copyable<I, O>
constexpr copy_n_result<I, O>

    copy_n( I first, std::iter_difference_t<I> n, O result );
(1) (C++20 起)
辅助类型
template< class I, class O >
using copy_n_result = ranges::in_out_result<I, O>;
(2) (C++20 起)
1) 从始于 first 的范围复制恰好 n 个值到始于 result 的范围,通过对 [0n) 中的每个整数 i 执行 *(result + i) = *(first + i)。如果 result 位于范围 [firstfirst + n) 之内,则行为未定义(这种情况下可以改用 ranges::copy_backward)。

本页描述的类函数实体是 算法函数对象(非正式地称为 niebloids),即

目录

[编辑] 参数

first - 要复制的元素范围的起始
n - 要复制的元素数量
result - 目标范围的开头

[编辑] 返回值

ranges::copy_n_result{first + n, result + n} 或更正式地,一个类型为 ranges::in_out_result 的值,它包含一个等于 ranges::next(first, n)input_iterator 迭代器和一个等于 ranges::next(result, n)weakly_incrementable 迭代器。

[编辑] 复杂度

恰好 n 次赋值。

[编辑] 注意

实践中,如果值类型为 TriviallyCopyable 且迭代器类型满足 contiguous_iteratorstd::ranges::copy_n 的实现可能避免多次赋值并使用批量复制函数,例如 std::memmove。或者,这种复制加速可以在编译器的优化阶段注入。

当复制重叠范围时,当向左复制(目标范围的起始在源范围之外)时,std::ranges::copy_n 是合适的;而当向右复制(目标范围的结束在源范围之外)时,std::ranges::copy_backward 是合适的。

[编辑] 可能的实现

struct copy_n_fn
{
    template<std::input_iterator I, std::weakly_incrementable O>
    requires std::indirectly_copyable<I, O>
    constexpr ranges::copy_n_result<I, O>
        operator()(I first, std::iter_difference_t<I> n, O result) const
    {
        for (; n-- > 0; (void)++first, (void)++result)
            *result = *first;
 
        return {std::move(first), std::move(result)};
    }
};
 
inline constexpr copy_n_fn copy_n{};

[编辑] 示例

#include <algorithm>
#include <iomanip>
#include <iostream>
#include <iterator>
#include <string>
#include <string_view>
 
int main()
{
    const std::string_view in{"ABCDEFGH"};
    std::string out;
 
    std::ranges::copy_n(in.begin(), 4, std::back_inserter(out));
    std::cout << std::quoted(out) << '\n';
 
    out = "abcdefgh";
    const auto res{std::ranges::copy_n(in.begin(), 5, out.begin())};
    const auto i{std::distance(std::begin(in), res.in)};
    const auto j{std::distance(std::begin(out), res.out)};
    std::cout << "in[" << i << "] = '" << in[i] << "'\n"
              << "out[" << j << "] = '" << out[j] << "'\n";
}

输出

"ABCD"
in[5] = 'F'
out[5] = 'f'

[编辑] 参阅

将一个范围的元素复制到一个新位置
(算法函数对象)[编辑]
以逆序复制一个范围的元素
(算法函数对象)[编辑]
复制一个范围的元素,忽略那些满足特定条件的元素
(算法函数对象)[编辑]
复制一个范围,同时用另一个值替换满足特定条件的元素
(算法函数对象)[编辑]
创建一个反转后的范围副本
(算法函数对象)[编辑]
复制并旋转一个范围的元素
(算法函数对象)[编辑]
创建一个不含连续重复元素的某个元素范围的副本
(算法函数对象)[编辑]
将一个范围的元素移动到一个新位置
(算法函数对象)[编辑]
以逆序将一个范围的元素移动到一个新位置
(算法函数对象)[编辑]
(C++11)
将一定数量的元素复制到一个新位置
(函数模板) [编辑]