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

반복자 타입이 변경 가능한 경우, f 는 역참조된 반복자를 통해 범위의 요소들을 수정할 수 있습니다. 만약 f 가 결과를 반환하면, 해당 결과는 무시됩니다. 만약 n 이 0보다 작으면, 동작은 정의되지 않습니다.

이 페이지에서 설명하는 함수형 개체들은 algorithm function objects (일반적으로 niebloids 로 알려진)입니다. 즉:

• 명시적 템플릿 인수 목록은 이들 중 어느 것을 호출할 때도 지정할 수 없습니다.
• 이들 중 어느 것도 인수 의존 탐색 에 보이지 않습니다.
• 이들 중 어느 것이 일반 비한정 탐색 에 의해 함수 호출 연산자의 왼쪽 이름으로 발견될 때, 인수 의존 탐색 이 억제됩니다.

매개변수

반환값

객체 { first + n, std :: move ( f ) } 를 반환하며, 여기서 first + n 은 반복자 카테고리에 따라 std :: ranges:: next ( std :: move ( first ) , n ) 로 평가될 수 있습니다.

복잡도

정확히 n 번의 f 와 proj 적용.

가능한 구현

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);
    // 처음 세 숫자를 음수로 변환:
    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);
    // 프로젝션을 사용하여 데이터 멤버 'P::first'를 음수로 변환:
    std::ranges::for_each_n(s.begin(), 2, [](auto& x) { x *= -1; }, &P::first);
    print("s", s);
    // 프로젝션을 사용하여 데이터 멤버 'P::second'를 대문자로 변환:
    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'}

참고 항목