Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes