std::ranges::for_each_n, std::ranges::for_each_n_result
cppreference.net에서
| 헤더 <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> count,
Fun f, Proj proj = {} );
|
(1) | (C++20부터) |
template< /*execution-policy*/ Ep,
std::random_access_iterator I, class Proj = identity,
std::indirectly_unary_invocable<std::projected<I, Proj>> Fun >
I for_each_n( Ep&& policy, I first, iter_difference_t<I> count,
Fun f, Proj proj = {} );
|
(2) | (C++26부터) |
| 헬퍼 타입 |
||
template< class I, class F >
using for_each_n_result = ranges::in_fun_result<I, F>;
|
(3) | (C++20부터) |
/*execution-policy*/의 정의는 이 페이지를 참조하십시오.
주어진 호출 가능 객체 f를 대상 범위 proj의 각 요소에 ([first, ranges::next(first, count))에 의해 투영되어) 적용합니다. f가 결과를 반환하면 그 결과는 무시됩니다.
1)
f가 first부터 순서대로 적용됩니다.2)
f는 순서대로 적용되지 않을 수 있습니다. 알고리즘은 policy에 따라 실행됩니다. 다른 병렬 알고리즘과 달리,
for_each_n는 대상 범위의 요소를 임의로 복사하는 것이 허용되지 않습니다.만약 count >= 0가 true이 아니라면, 동작은 정의되지 않습니다.
이 페이지에 설명된 함수형 객체들은 알고리즘 함수 객체 (비공식적으로 니블로이드라고 함)입니다. 즉:
- 그들 중 어느 것을 호출할 때 명시적 템플릿 인자 목록을 지정할 수 없습니다.
- 그들 중 어느 것도 인자 종속 조회에 보이지 않습니다.
- 그들 중 어느 것이 함수 호출 연산자의 왼쪽에 있는 이름으로 일반 비한정 조회에 의해 발견되면, 인자 종속 조회가 억제됩니다.
매개변수
| first | - | 대상 범위의 시작 |
| count | - | 대상 범위에 있는 요소의 개수 |
| f | - | (투영된) 요소에 적용될 호출 가능 객체 |
| proj | - | 요소에 적용될 투영 |
| policy | - | 사용할 실행 정책 |
반환값
1)
{ranges::next(first, count), std::move(f)}2)
ranges::next(first, count)복잡도
정확히 count번의 f 및 proj 적용.
예외
2) 실행 과정 중:
- 병렬화에 필요한 임시 메모리 자원을 사용할 수 없는 경우, std::bad_alloc가 throw됩니다.
- 알고리즘 인수를 통해 객체에 접근하는 동안 처리되지 않은 예외가 throw되는 경우, 동작은 실행 정책에 의해 결정됩니다 (표준 정책, std::terminate가 호출됩니다).
참고
프로젝션이 변경 가능한 참조를 반환하는 경우, f는 대상 범위의 요소를 수정할 수 있습니다.
가능한 구현
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> count,
Fun fun, Proj proj = Proj{}) const
{
for (; count-- > 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, const auto& 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'}
참고 항목
(C++17) |
시퀀스의 처음 N개 요소에 함수 객체를 적용합니다 (함수 템플릿) |
| 단항 함수 객체를 범위의 요소들에 적용합니다 (함수 템플릿 & 알고리즘 함수 객체) | |
(C++20) |
|
범위 기반 for for루프(C++11)
|
범위에 대해 루프를 실행합니다 |