23 Algorithms library [algorithms]

23.5 Non-modifying sequence operations [alg.nonmodifying]

23.5.4 For each [alg.foreach]

🔗
template<class InputIterator, class Function> constexpr Function for_each(InputIterator first, InputIterator last, Function f);
1
#
Requires: Function shall satisfy the Cpp17MoveConstructible requirements (Table 25).
[ Note
:
Function need not meet the requirements of Cpp17CopyConstructible (Table 26).
— end note
 ]
2
#
Effects: Applies f to the result of dereferencing every iterator in the range [first, last), starting from first and proceeding to last - 1.
[ Note
:
If the type of first satisfies the requirements of a mutable iterator, f may apply non-constant functions through the dereferenced iterator.
— end note
 ]
3
#
Returns: f.
4
#
Complexity: Applies f exactly last - first times.
5
#
Remarks: If f returns a result, the result is ignored.
🔗
template<class ExecutionPolicy, class ForwardIterator, class Function> void for_each(ExecutionPolicy&& exec, ForwardIterator first, ForwardIterator last, Function f);
6
#
Requires: Function shall satisfy the Cpp17CopyConstructible requirements.
7
#
Effects: Applies f to the result of dereferencing every iterator in the range [first, last).
[ Note
:
If the type of first satisfies the requirements of a mutable iterator, f may apply non-constant functions through the dereferenced iterator.
— end note
 ]
8
#
Complexity: Applies f exactly last - first times.
9
#
Remarks: If f returns a result, the result is ignored.
Implementations do not have the freedom granted under [algorithms.parallel.exec] to make arbitrary copies of elements from the input sequence.
10
#
[ Note
:
Does not return a copy of its Function parameter, since parallelization may not permit efficient state accumulation.
— end note
 ]
🔗
template<class InputIterator, class Size, class Function> constexpr InputIterator for_each_n(InputIterator first, Size n, Function f);
11
#
Requires: Function shall satisfy the Cpp17MoveConstructible requirements
[ Note
:
Function need not meet the requirements of Cpp17CopyConstructible.
— end note
 ]
12
#
Requires: n >= 0.
13
#
Effects: Applies f to the result of dereferencing every iterator in the range [first, first + n) in order.
[ Note
:
If the type of first satisfies the requirements of a mutable iterator, f may apply non-constant functions through the dereferenced iterator.
— end note
 ]
14
#
Returns: first + n.
15
#
Remarks: If f returns a result, the result is ignored.
🔗
template<class ExecutionPolicy, class ForwardIterator, class Size, class Function> ForwardIterator for_each_n(ExecutionPolicy&& exec, ForwardIterator first, Size n, Function f);
16
#
Requires: Function shall satisfy the Cpp17CopyConstructible requirements.
17
#
Requires: n >= 0.
18
#
Effects: Applies f to the result of dereferencing every iterator in the range [first, first + n).
[ Note
:
If the type of first satisfies the requirements of a mutable iterator, f may apply non-constant functions through the dereferenced iterator.
— end note
 ]
19
#
Returns: first + n.
20
#
Remarks: If f returns a result, the result is ignored.
Implementations do not have the freedom granted under [algorithms.parallel.exec] to make arbitrary copies of elements from the input sequence.