WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::for_each: eine Funktion für jedes Element aufrufen

std::for_each ruft eine Funktion für jedes Element in [first, last) auf; die sequenzielle Form bewahrt die Reihenfolge und liefert das Funktionsobjekt.

Version: C++23

Syntax

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) aus <algorithm> ruft f(*i) genau einmal für jedes der N Elemente in Bereichsreihenfolge ab first auf. Bei veränderlichem Iterator darf die Funktion das Element ändern. Der Overload ohne Richtlinie ist constexpr, verlangt ein move-konstruierbares Function und liefert f; der Richtlinienoverload verlangt ein kopierbares Function, darf Aufrufe umordnen und liefert void.

Das Beispiel summiert Werte in einer externen Variablen, verdoppelt jedes Element und gibt 6 2 4 6 aus. Ein Rückgabewert von operator() wird ignoriert. Bei leerem Bereich erfolgt kein Aufruf. Die externe Summe vermeidet bewusst die Annahme, Zustände beliebiger Kopien des Funktionsobjekts würden zusammengeführt.

Algorithmen dürfen Funktionsobjekte kopieren; bei wichtiger Identität sind std::ref oder hinreichend langlebiger externer Zustand geeignet. Ohne Richtlinie wird eine Ausnahme aus f weitergereicht, wobei frühere Elemente schon geändert sein können. Mit Standardrichtlinie führt sie zu std::terminate; Speichermangel kann std::bad_alloc auslösen. Unsynchronisierte parallele Änderung gemeinsamen Zustands ist ein Datenrennen; unsequenced-Richtlinien verbieten zusätzlich nicht vektorisierungssichere Operationen.

Beispiele

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

Ergebnis

6 2 4 6

std::for_each → 6 2 4 6

Quellen