CKTIS / C++
std::for_each: invocar uma função para cada elemento
std::for_each invoca uma função para cada elemento em [first, last); a forma sequencial preserva a ordem e devolve o objeto função.
Versão: C++23
Sintaxe
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) de <algorithm> chama f(*i) exatamente uma vez para cada um dos N elementos, desde first pela ordem do intervalo. Se o iterador for modificável, a função pode alterar o elemento. A sobrecarga sem política é constexpr, exige um Function construível por movimento e devolve f; a que recebe política exige um Function copiável, pode reordenar chamadas e devolve void.
O exemplo acumula valores numa variável externa, duplica cada elemento e imprime 6 2 4 6. Qualquer valor devolvido por operator() é ignorado. Num intervalo vazio a função não é chamada. A soma externa evita deliberadamente assumir que o estado de cópias arbitrárias do objeto função será combinado.
Os algoritmos podem copiar objetos função; quando a identidade importa, usa std::ref ou estado externo com vida suficiente. Sem política, uma exceção de f propaga-se e elementos anteriores podem já ter mudado. Com política padrão, chama std::terminate; a memória temporária pode falhar com std::bad_alloc. Alterar estado partilhado em paralelo sem sincronização causa data race; políticas unsequenced também proíbem operações inseguras para vetorização.
Exemplos
#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';
}
Resultado
6 2 4 6
std::for_each → 6 2 4 6