CKTIS / C++
std::for_each: klic funkcije za vsak element
std::for_each pokliče funkcijo za vsak element v [first, last); zaporedna oblika ohrani vrstni red in vrne funkcijski objekt.
Različica: C++23
Sintaksa
template<class InputIterator, class Function>
constexpr Function std::for_each(
InputIterator first, InputIterator last, Function f);
template<class ExecutionPolicy, class ForwardIterator, class Function>
void std::for_each(ExecutionPolicy&& exec,
ForwardIterator first, ForwardIterator last, Function f);std::for_each(first, last, f) iz <algorithm> pokliče f(*i) natanko enkrat za vsakega od N elementov, od first po vrstnem redu območja. Če je iterator spremenljiv, lahko funkcija spremeni element. Preobremenitev brez politike je constexpr, zahteva premakljivo konstruiran Function in vrne f; oblika s politiko zahteva kopirljiv Function, lahko preuredi klice in vrne void.
Primer sešteje vrednosti v zunanji spremenljivki, podvoji vsak element in izpiše 6 2 4 6. Vrnjen rezultat operator() se prezre. Pri praznem območju se funkcija ne pokliče. Zunanja vsota namenoma ne predpostavlja, da se stanje poljubnih kopij funkcijskega objekta združi.
Algoritmi lahko kopirajo funkcijske objekte; če je pomembna identiteta, uporabite std::ref ali dovolj dolgo živeče zunanje stanje. Brez politike se izjema iz f razširi in prejšnji elementi so lahko že spremenjeni. S standardno politiko vodi v std::terminate; pomanjkanje pomnilnika lahko vrže std::bad_alloc. Nesinhronizirana vzporedna sprememba skupnega stanja je data race; unsequenced politike prepovedujejo tudi operacije, nevarne za vektorizacijo.
Primeri
#include <algorithm>
#include <array>
#include <iostream>
int main() {
std::array values{1, 2, 3};
int sum = 0;
std::for_each(values.begin(), values.end(), [&](int& value) {
sum += value;
value *= 2;
});
std::cout << sum;
for (int value : values) {
std::cout << ' ' << value;
}
std::cout << '\n';
}
Rezultat
6 2 4 6
std::for_each → 6 2 4 6