28 Algorithms library [algorithms]

28.5 Non-modifying sequence operations [alg.nonmodifying]

28.5.4 For each [alg.foreach]

template<class InputIterator, class Function> Function for_each(InputIterator first, InputIterator last, Function f);

Requires: Function должны соответствовать требованиям MoveConstructible. [ Note: Function не обязательно соответствовать требованиям CopyConstructible. ] end note

Effects: Применяется f к результату разыменования каждого итератора в диапазоне [first, last), начиная с first и продолжаясь до last - 1. [ Note: Если тип first удовлетворяет требованиям изменяемого итератора, f может применять непостоянные функции через разыменованный итератор. ]end note

Returns: f.

Complexity: Применяется f ровно last - first раз.

Remarks: Если f возвращает результат, результат игнорируется.

template<class ExecutionPolicy, class ForwardIterator, class Function> void for_each(ExecutionPolicy&& exec, ForwardIterator first, ForwardIterator last, Function f);

Requires: Function должны соответствовать требованиям CopyConstructible.

Effects: Применяется f к результату разыменования каждого итератора в диапазоне [first, last). [ Note: Если тип first удовлетворяет требованиям изменяемого итератора, f может применять непостоянные функции через разыменованный итератор. ]end note

Complexity: Применяется f ровно last - first раз.

Remarks: Если f возвращает результат, результат игнорируется. Реализации не имеют права [algorithms.parallel.exec] делать произвольные копии элементов из входной последовательности.

[ Note: Не возвращает копию своего Function параметра, поскольку распараллеливание может не позволить эффективное накопление состояний. ] end note

template<class InputIterator, class Size, class Function> InputIterator for_each_n(InputIterator first, Size n, Function f);

Requires: Function должны соответствовать требованиям MoveConstructible [ Note: Function не обязательно отвечать требованиям CopyConstructible. ] end note

Requires: n >= 0.

Effects: Применяется f к результату разыменования каждого итератора в диапазоне [first, first + n) по порядку. [ Note: Если тип first удовлетворяет требованиям изменяемого итератора, f может применять непостоянные функции через разыменованный итератор. ]end note

Returns: first + n.

Remarks: Если f возвращает результат, результат игнорируется.

template<class ExecutionPolicy, class ForwardIterator, class Size, class Function> ForwardIterator for_each_n(ExecutionPolicy&& exec, ForwardIterator first, Size n, Function f);

Requires: Function должны соответствовать требованиям CopyConstructible.

Requires: n >= 0.

Effects: Применяется f к результату разыменования каждого итератора в диапазоне [first, first + n). [ Note: Если тип first удовлетворяет требованиям изменяемого итератора, f может применять непостоянные функции через разыменованный итератор. ]end note

Returns: first + n.

Remarks: Если f возвращает результат, результат игнорируется. Реализации не имеют права [algorithms.parallel.exec] делать произвольные копии элементов из входной последовательности.