std::copy_n

定义在头文件 `<algorithm>` 中
template< class InputIt, class Size, class OutputIt > OutputIt copy_n( InputIt first, Size count, OutputIt result );	(1)	(自 C++11 起) (自 C++20 起为 constexpr)
template< class ExecutionPolicy, class ForwardIt1, class Size, class ForwardIt2 > ForwardIt2 copy_n( ExecutionPolicy&& policy, ForwardIt1 first, Size count, ForwardIt2 result );	(2)	(自 C++17 起)

1) 将从以 first 开头的范围到以 result 开头的范围中恰好 count 个值复制。形式上，对于 [0, count) 中的每个整数 i，执行 *(result + i) = *(first + i).

允许范围重叠，但这会导致结果排序不可预测。

2) 与 (1) 相同，但根据 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 起)

[编辑] 参数

first	-	要从中复制的元素范围的开头
count	-	要复制的元素数量
result	-	目标范围的开头
policy	-	要使用的执行策略。有关详细信息，请参见执行策略。
类型要求
- `InputIt` 必须满足 LegacyInputIterator 的要求。
- `OutputIt` 必须满足 LegacyOutputIterator 的要求。
- `ForwardIt1, ForwardIt2` 必须满足 LegacyForwardIterator 的要求。

[编辑] 返回值

目标范围中的迭代器，如果 count > 0，则指向最后一个复制的元素之后，否则指向 result。

[编辑] 复杂度

如果 count < 0，则为零次赋值；否则为 count 次赋值。

[编辑] 异常

具有名为 ExecutionPolicy 的模板参数的重载报告错误如下

如果在算法执行过程中，作为算法一部分调用的函数抛出异常，并且 `ExecutionPolicy` 是标准策略之一，则调用 std::terminate。对于任何其他 `ExecutionPolicy`，行为是实现定义的。
如果算法无法分配内存，则抛出 std::bad_alloc。

[编辑] 可能的实现

template<class InputIt, class Size, class OutputIt>
constexpr //< since C++20
OutputIt copy_n(InputIt first, Size count, OutputIt result)
{
    if (count > 0)
    {
        *result = *first;
        ++result;
        for (Size i = 1; i != count; ++i, ++result)
            *result = *++first;
    }
 
    return result;
}

[编辑] 示例

运行此代码

#include <algorithm>
#include <iostream>
#include <iterator>
#include <numeric>
#include <string>
#include <vector>
 
int main()
{
    std::string in {"1234567890"};
    std::string out;
 
    std::copy_n(in.begin(), 4, std::back_inserter(out));
    std::cout << out << '\n';
 
    std::vector<int> v_in(128);
    std::iota(v_in.begin(), v_in.end(), 1);
    std::vector<int> v_out(v_in.size());
 
    std::copy_n(v_in.cbegin(), 100, v_out.begin());
    std::cout << std::accumulate(v_out.begin(), v_out.end(), 0) << '\n';
}

输出

1234
5050

[编辑] 另请参阅

copycopy_if (C++11)	将一个范围内的元素复制到新的位置 (函数模板) [编辑]
ranges::copy_n (C++20)	将一定数量的元素复制到新的位置 (niebloid)[编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作