CKTIS / C++
std::for_each: een functie voor elk element aanroepen
std::for_each roept een functie aan voor elk element in [first, last); de sequentiële vorm bewaart de volgorde en retourneert het functieobject.
Versie: C++23
Syntax
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) uit <algorithm> roept f(*i) precies eenmaal aan voor elk van de N elementen, vanaf first in bereikvolgorde. Bij een wijzigbare iterator mag de functie het element aanpassen. De overload zonder beleid is constexpr, vereist een move-constructible Function en retourneert f; de beleidsoverload vereist een kopieerbaar Function, mag aanroepen herschikken en retourneert void.
Het voorbeeld telt waarden op in een externe variabele, verdubbelt elk element en print 6 2 4 6. Een retourwaarde van operator() wordt genegeerd. Voor een leeg bereik wordt de functie niet aangeroepen. De externe som vermijdt bewust de aanname dat de toestand van willekeurige kopieën van het functieobject wordt samengevoegd.
Algoritmen mogen functieobjecten kopiëren; als identiteit telt, gebruik std::ref of externe toestand met voldoende levensduur. Zonder beleid wordt een exceptie uit f doorgegeven en kunnen eerdere elementen al gewijzigd zijn. Met standaard beleid leidt ze tot std::terminate; geheugentekort kan std::bad_alloc opleveren. Ongesynchroniseerde parallelle wijziging van gedeelde toestand is een data race; unsequenced-beleid verbiedt ook vectorisatie-onveilige operaties.
Voorbeelden
#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';
}
Resultaat
6 2 4 6
std::for_each → 6 2 4 6