Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::for_each: invocare una funzione per ogni elemento

std::for_each invoca una funzione per ogni elemento in [first, last); la forma sequenziale conserva l’ordine e restituisce l’oggetto funzione.

Versione: C++23

Sintassi

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) di <algorithm> invoca f(*i) esattamente una volta per ciascuno degli N elementi, da first nell’ordine dell’intervallo. Se l’iteratore è mutabile, la funzione può modificare l’elemento. L’overload senza policy è constexpr, richiede un Function costruibile per movimento e restituisce f; quello con policy richiede un Function copiabile, può riordinare le chiamate e restituisce void.

L’esempio accumula i valori in una variabile esterna, raddoppia ogni elemento e stampa 6 2 4 6. Qualsiasi valore restituito da operator() è ignorato. Per un intervallo vuoto la funzione non viene invocata. La somma esterna evita volutamente di presumere che lo stato di copie arbitrarie dell’oggetto funzione venga unito.

Gli algoritmi possono copiare gli oggetti funzione; se conta l’identità, usa std::ref o stato esterno con vita sufficiente. Senza policy un’eccezione da f si propaga e gli elementi precedenti possono essere già cambiati. Con policy standard chiama std::terminate; la memoria temporanea può fallire con std::bad_alloc. Modificare in parallelo stato condiviso senza sincronizzazione causa data race; le policy unsequenced vietano inoltre operazioni non sicure per la vettorizzazione.

Esempi

#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';
}

Risultato

6 2 4 6

std::for_each → 6 2 4 6

Fonti