Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::for_each : appeler une fonction pour chaque élément

std::for_each appelle une fonction pour chaque élément de [first, last) ; la forme séquentielle conserve l’ordre et renvoie l’objet fonction.

Version : C++23

Syntaxe

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> appelle f(*i) exactement une fois pour chacun des N éléments, depuis first dans l’ordre de la plage. Si l’itérateur est modifiable, la fonction peut modifier l’élément. La surcharge sans politique est constexpr, exige un Function déplaçable et renvoie f ; celle avec politique exige un Function copiable, peut réordonner les appels et renvoie void.

L’exemple accumule les valeurs dans une variable externe, double chaque élément et affiche 6 2 4 6. Toute valeur renvoyée par operator() est ignorée. Pour une plage vide, la fonction n’est pas appelée. La somme externe évite de supposer que l’état de copies arbitraires de l’objet fonction sera fusionné.

Les algorithmes peuvent copier les objets fonction ; si l’identité compte, utilisez std::ref ou un état externe vivant assez longtemps. Sans politique, une exception de f se propage et des éléments antérieurs peuvent déjà avoir changé. Avec une politique standard, elle appelle std::terminate ; le manque de mémoire peut lancer std::bad_alloc. Modifier en parallèle un état partagé sans synchronisation crée une course ; les politiques unsequenced interdisent aussi les opérations non sûres pour la vectorisation.

Exemples

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

Résultat

6 2 4 6

std::for_each → 6 2 4 6

Sources