Namespaces
Variants

    std::experimental::ranges:: for_each

    From de.cppreference.net
    C++
    Experimental
    Ranges
    Algorithms library
    Non-modifying sequence operations
    Modifying sequence operations
    Partitioning operations
    Sorting operations
    Binary search operations
    Set operations (on sorted ranges)
    Heap operations
    Minimum/maximum operations
    Permutations
    template < InputIterator I, Sentinel < I > S, class Proj = ranges:: identity ,

    IndirectUnaryInvocable < projected < I, Proj >> Fun >
    ranges:: tagged_pair < tag:: in ( I ) , tag:: fun ( Fun ) >

    for_each ( I first, S last, Fun f, Proj proj = Proj { } ) ;
    		(1) (ranges TS)
    template < InputRange R, class Proj = ranges:: identity ,

    IndirectUnaryInvocable < projected < ranges:: iterator_t < R > , Proj >> Fun >
    ranges:: tagged_pair < tag:: in ( ranges:: safe_iterator_t < R > ) , tag:: fun ( Fun ) >

    for_each ( R && r, Fun f, Proj proj = Proj { } ) ;
    		(2) (ranges TS)
    1) Ruft das gegebene Funktionsobjekt f mit dem Ergebnis des Aufrufs der Projektion proj auf das Dereferenzieren jedes Iterators im Bereich [ first , last ) auf (d.h. ranges:: invoke ( f, ranges:: invoke ( proj, * i ) ) ), in Reihenfolge.
    2) Gleich wie (1) , verwendet jedoch r als Quellbereich, als ob ranges:: begin ( r ) als first und ranges:: end ( r ) als last verwendet würde.

    Für beide Überladungen gilt: Wenn der Iteratortyp veränderbar ist, f kann die Elemente des Bereichs durch den dereferenzierten Iterator modifizieren. Wenn f ein Ergebnis zurückgibt, wird das Ergebnis ignoriert.

    Im Gegensatz zu den restlichen Algorithmen ist es for_each nicht gestattet, Kopien der Elemente in der Sequenz zu erstellen, selbst wenn sie trivial kopierbar sind.

    Im Gegensatz zu std::for_each (welches nur MoveConstructible erfordert), benötigen diese Funktionen, dass Fun das Konzept CopyConstructible modelliert.

    Ungeachtet der oben dargestellten Deklarationen sind die tatsächliche Anzahl und Reihenfolge der Template-Parameter für Algorithmusdeklarationen nicht spezifiziert. Daher ist das Programm wahrscheinlich nicht portabel, wenn explizite Template-Argumente beim Aufruf eines Algorithmus verwendet werden.

    Inhaltsverzeichnis

    Parameter

    first, last - der Bereich, auf den die Funktion angewendet werden soll
    r - der Bereich, auf den die Funktion angewendet werden soll
    f - aufrufbares Objekt, das auf jedes projizierte Element im Bereich angewendet werden soll
    proj - Projektion, die auf die Elemente angewendet werden soll

    Rückgabewert

    Ein tagged_pair -Objekt, das die folgenden zwei Elemente enthält:

    • Das erste Element, mit dem Tag tag::in , ist der Past-the-End-Iterator des Quellbereichs (also ein Iterator vom Typ I , der gleich dem Sentinel last ist).
    • Das zweite Element, mit dem Tag tag::fun , wird von std::move(f) initialisiert (nach allen Anwendungen des Funktionsobjekts).

    Komplexität

    Genau last - first Anwendungen von f und proj .

    Mögliche Implementierung 

    template<InputIterator I, Sentinel<I> S, class Proj = ranges::identity,
         IndirectUnaryInvocable<ranges::projected<I, Proj>> Fun>
auto for_each(I first, S last, Fun f, Proj proj = Proj{}) 
    -> ranges::tagged_pair<tag::in(I), tag::fun(Fun)>
{
    for (; first != last; ++first)
        ranges::invoke(f, ranges::invoke(proj, *first));
    return {std::move(first), std::move(f)};
}

    Beispiel

    Dieser Abschnitt ist unvollständig
    Grund: Kein Beispiel

    Siehe auch

    		 wendet eine Funktion auf einen Bereich von Elementen an
    (Funktionsschablone)
    Bereichs-forSchleife(C++11) führt eine Schleife über einen Bereich aus
    		wendet ein unäresFunktionsobjektauf Elemente aus einemBereich
    (Funktionsschablone & Algorithmus-Funktionsobjekt)
    (C++20)
    (C++17)
    		 wendet ein Funktionsobjekt auf die ersten N Elemente einer Sequenz an
    (Funktionsschablone & Algorithmus-Funktionsobjekt)
    (C++20)