当前位置:   article > 正文

C++标准模板(STL)- 算法 (std::copy_n)_std::copy在哪个头文件

std::copy在哪个头文件
定义于头文件 <algorithm>
算法库提供大量用途的函数(例如查找、排序、计数、操作),它们在元素范围上操作。注意范围定义为 [first, last) ,其中 last 指代要查询或修改的最后元素的后一个元素。

将一定数目的元素复制到一个新的位置

std::copy_n

template< class InputIt, class Size, class OutputIt >
OutputIt copy_n( InputIt first, Size count, OutputIt result );

(1)(C++11 起)
(C++20 前)

template< class InputIt, class Size, class OutputIt >
constexpr OutputIt copy_n( InputIt first, Size count, OutputIt result );

(C++20 起)

template< class ExecutionPolicy, class ForwardIt1, class Size, class ForwardIt2 >
ForwardIt2 copy_n( ExecutionPolicy&& policy, ForwardIt1 first, Size count, ForwardIt2 result );

(2)(C++17 起)

1) 若 count>0 ,则准确复制来自始于 first 的范围的 count 个值到始于 result 的范围。正式而言,对于每个非负整数 i < n 进行 *(result + i) = *(first + i) 。不同于 std::copy ,本算法容许重叠。

2) 同 (1) ,但按照 policy 执行。此重载仅若 std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> 为 true 才参与重载决议。

参数

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 。

可能的实现

 

  1. template< class InputIt, class Size, class OutputIt>
  2. OutputIt copy_n(InputIt first, Size count, OutputIt result)
  3. {
  4. if (count > 0) {
  5. *result++ = *first;
  6. for (Size i = 1; i < count; ++i) {
  7. *result++ = *++first;
  8. }
  9. }
  10. return result;
  11. }

调用示例

  1. #include <iostream>
  2. #include <vector>
  3. #include <algorithm>
  4. #include <iterator>
  5. int main()
  6. {
  7. std::vector<int> in = {1, 2, 3, 4, 5, 6, 7, 8, 9};
  8. std::cout << "in : ";
  9. std::copy(in.begin(), in.end(), std::ostream_iterator<int>(std::cout, " "));
  10. std::cout << std::endl;
  11. std::vector<int> out;
  12. std::copy_n(in.begin(), 5, std::back_inserter(out));
  13. std::cout << "out : ";
  14. std::copy(out.begin(), out.end(), std::ostream_iterator<int>(std::cout, " "));
  15. std::cout << std::endl;
  16. std::vector<int> out1(6);
  17. std::copy_n(in.begin(), out1.size(), std::begin(out1));
  18. std::cout << "out1: ";
  19. std::copy(out1.begin(), out1.end(), std::ostream_iterator<int>(std::cout, " "));
  20. std::cout << std::endl;
  21. }

输出

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/羊村懒王/article/detail/707812
推荐阅读
相关标签
  

闽ICP备14008679号