CKTIS / C++
std::for_each: pozivanje funkcije za svaki element
std::for_each poziva funkciju za svaki element u [first, last); slijedni oblik čuva redoslijed i vraća funkcijski objekt.
Verzija: 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> poziva f(*i) točno jednom za svaki od N elemenata, od first redoslijedom raspona. Ako je iterator promjenjiv, funkcija može promijeniti element. Preopterećenje bez politike jest constexpr, zahtijeva premještanjem konstruiran Function i vraća f; oblik s politikom zahtijeva kopirljiv Function, može promijeniti redoslijed poziva i vraća void.
Primjer zbraja vrijednosti u vanjskoj varijabli, udvostručuje svaki element i ispisuje 6 2 4 6. Povratna vrijednost operator() zanemaruje se. Za prazan raspon funkcija se ne poziva. Vanjski zbroj namjerno ne pretpostavlja da će se stanje proizvoljnih kopija funkcijskog objekta spojiti.
Algoritmi mogu kopirati funkcijske objekte; kada je identitet važan, koristi std::ref ili dovoljno dugo živ vanjski state. Bez politike iznimka iz f propagira se, a raniji elementi mogu već biti promijenjeni. Sa standardnom politikom vodi u std::terminate; manjak memorije može baciti std::bad_alloc. Nesinkronizirana paralelna promjena dijeljenog stanja jest data race; unsequenced politike dodatno zabranjuju operacije nesigurne za vektorizaciju.
Primjeri
#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