std:: for_each

Wendet das gegebene unäre Funktionsobjekt f auf das Ergebnis der Dereferenzierung jedes Iterators im Bereich [ first , last ) an. Falls f ein Ergebnis zurückgibt, wird das Ergebnis ignoriert.

Wenn der Iteratortyp ( InputIt / ForwardIt ) mutable ist, f kann die Elemente des Bereichs durch den dereferenzierten Iterator modifizieren.

Im Gegensatz zu den anderen parallelen Algorithmen ist es for_each nicht erlaubt, Kopien der Elemente in der Sequenz zu erstellen, selbst wenn sie TriviallyCopyable sind.

Parameter

Rückgabewert

Komplexität

Genau std:: distance ( first, last ) Anwendungen von f .

Ausnahmen

Die Überladung mit einem Template-Parameter namens ExecutionPolicy meldet Fehler wie folgt:

• Wenn die Ausführung einer als Teil des Algorithmus aufgerufenen Funktion eine Exception wirft und ExecutionPolicy einer der Standard-Policies ist, wird std::terminate aufgerufen. Für jede andere ExecutionPolicy ist das Verhalten implementierungsdefiniert.
• Wenn der Algorithmus keinen Speicher allozieren kann, wird std::bad_alloc geworfen.

Mögliche Implementierung

Siehe auch die Implementierungen in libstdc++ , libc++ und MSVC stdlib .

template<class InputIt, class UnaryFunc>
constexpr UnaryFunc for_each(InputIt first, InputIt last, UnaryFunc f)
{
    for (; first != last; ++first)
        f(*first);
    return f; // implizites Move seit C++11
}

Hinweise

Für Überladung ( 1 ) kann f ein zustandsbehaftetes Funktionsobjekt sein. Der Rückgabewert kann als Endzustand des Stapelvorgangs betrachtet werden.

Für Überladung ( 2 ) können mehrere Kopien von f erstellt werden, um parallelen Aufruf durchzuführen. Es wird kein Wert zurückgegeben, da Parallelisierung häufig keine effiziente Zustandsakkumulation erlaubt.

Beispiel

#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    std::vector<int> v{3, -4, 2, -8, 15, 267};
    auto print = [](const int& n) { std::cout << n << ' '; };
    std::cout << "before:\t";
    std::for_each(v.cbegin(), v.cend(), print);
    std::cout << '\n';
    // Elemente direkt inkrementieren
    std::for_each(v.begin(), v.end(), [](int & n) { n++; });
    std::cout << "after:\t";
    std::for_each(v.cbegin(), v.cend(), print);
    std::cout << '\n';
    struct Sum
    {
        void operator()(int n) { sum += n; }
        int sum {0};
    };
    // Sum::operator() für jedes Element aufrufen
    Sum s = std::for_each(v.cbegin(), v.cend(), Sum());    
    std::cout << "sum:\t" << s.sum << '\n';
}

before:	3 -4 2 -8 15 267 
after:	4 -3 3 -7 16 268 
sum:	281

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch