命名空间
变体
操作

std::ranges::for_each_n, std::ranges::for_each_n_result

来自 cppreference.com
< cpp‎ | algorithm‎ | ranges
 
 
算法库
约束算法和范围上的算法 (C++20)
约束算法,例如 ranges::copy, ranges::sort, ...
执行策略 (C++17)
排序和相关操作
分区操作
排序操作
二分搜索操作
(在分区范围内)
集合操作(在排序范围内)
合并操作(在排序范围内)
堆操作
最小/最大操作
(C++11)
(C++17)
字典序比较操作
排列操作
C 库
数值操作
未初始化内存操作
 
约束算法
此菜单中的所有名称都属于命名空间 std::ranges
非修改序列操作
修改序列操作
分区操作
排序操作
二分搜索操作(在排序范围内)
       
       
集合操作(在排序范围内)
堆操作
最小/最大操作
       
       
排列操作
折叠操作
数值操作
(C++23)            
未初始化存储操作
返回类型
 
定义在头文件 <algorithm>
调用签名
template< std::input_iterator I, class Proj = std::identity,

          std::indirectly_unary_invocable<std::projected<I, Proj>> Fun >
constexpr for_each_n_result<I, Fun>

    for_each_n( I first, std::iter_difference_t<I> n, Fun f, Proj proj = {});
(1) (自 C++20 起)
辅助类型
template< class I, class F >
using for_each_n_result = ranges::in_fun_result<I, F>;
(2) (自 C++20 起)
1) 按顺序将给定的函数对象 f 应用于范围内 [firstfirst + n) 中每个迭代器解引用后的投影结果(由 proj 投影)。

如果迭代器类型是可变的,则 f 可以通过解引用的迭代器修改范围内的元素。如果 f 返回结果,则忽略该结果。如果 n 小于零,则行为未定义。

此页面上描述的函数式实体是 niebloids,也就是说

实际上,它们可能被实现为函数对象,或者使用特殊的编译器扩展。

内容

[编辑] 参数

first - 表示要应用函数的范围起点的迭代器
n - 要应用函数的元素数量
f - 要应用于投影范围 [firstfirst + n) 的函数
proj - 要应用于元素的投影

[编辑] 返回值

一个对象 {first + n, std::move(f)},其中 first + n 可以根据迭代器类别被评估为 std::ranges::next(std::move(first), n)

[编辑] 复杂度

正好应用 nfproj

[编辑] 可能的实现

struct for_each_n_fn
{
    template<std::input_iterator I, class Proj = std::identity,
             std::indirectly_unary_invocable<std::projected<I, Proj>> Fun>
    constexpr for_each_n_result<I, Fun>
        operator()(I first, std::iter_difference_t<I> n, Fun fun, Proj proj = Proj{}) const
    {
        for (; n-- > 0; ++first)
            std::invoke(fun, std::invoke(proj, *first));
        return {std::move(first), std::move(fun)};
    }
};
 
inline constexpr for_each_n_fn for_each_n {};

[编辑] 示例

#include <algorithm>
#include <array>
#include <iostream>
#include <ranges>
#include <string_view>
 
struct P
{
    int first;
    char second;
    friend std::ostream& operator<<(std::ostream& os, const P& p)
    {
        return os << '{' << p.first << ",'" << p.second << "'}";
    }
};
 
auto print = [](std::string_view name, auto const& v)
{
    std::cout << name << ": ";
    for (auto n = v.size(); const auto& e : v)
        std::cout << e << (--n ? ", " : "\n");
};
 
int main()
{
    std::array a {1, 2, 3, 4, 5};
    print("a", a);
    // Negate first three numbers:
    std::ranges::for_each_n(a.begin(), 3, [](auto& n) { n *= -1; });
    print("a", a);
 
    std::array s { P{1,'a'}, P{2, 'b'}, P{3, 'c'}, P{4, 'd'} };
    print("s", s);
    // Negate data members 'P::first' using projection:
    std::ranges::for_each_n(s.begin(), 2, [](auto& x) { x *= -1; }, &P::first);
    print("s", s);
    // Capitalize data members 'P::second' using projection:
    std::ranges::for_each_n(s.begin(), 3, [](auto& c) { c -= 'a'-'A'; }, &P::second);
    print("s", s);
}

输出

a: 1, 2, 3, 4, 5
a: -1, -2, -3, 4, 5
s: {1,'a'}, {2,'b'}, {3,'c'}, {4,'d'}
s: {-1,'a'}, {-2,'b'}, {3,'c'}, {4,'d'}
s: {-1,'A'}, {-2,'B'}, {3,'C'}, {4,'d'}

[编辑] 另请参阅

range-for 循环(C++11) 在范围内执行循环[编辑]
将函数应用于一系列元素
(niebloid)[编辑]
将函数对象应用于序列的前 N 个元素
(函数模板) [编辑]
将函数应用于一系列元素
(函数模板) [编辑]