std::experimental::ranges::for_each

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Experimentell

Technische Spezifikation

Dateisystembibliothek (Filesystem TS)

Grundlagen der Bibliothek (Library Fundamentals TS)

Grundlagen der Bibliothek 2 (Library Fundamentals TS v2)

Grundlagen der Bibliothek 3 (Library Fundamentals TS v3)

Erweiterungen für Parallelität (Parallelism TS)

Erweiterungen für Parallelität 2 (Parallelism TS v2)

Erweiterungen für Nebenläufigkeit (Concurrency TS)

Erweiterungen für Nebenläufigkeit 2 (Concurrency TS v2)

Konzepte (Concepts TS)

Bereiche (Ranges TS)

Reflektion (Reflection TS)

Mathematische Spezialfunktionen (Special Functions TR)

Experimentell Nicht-TS

Pattern Matching

Lineare Algebra

std::execution

Verträge

2D-Grafik

 

Bereiche (Ranges)

Konzepte

Allgemeine Hilfsmittel

Iteratoren

Bereiche (Ranges)

Algorithmen

 

Algorithmen-Bibliothek

Nicht-modifizierende Sequenzoperationen
all_ofany_ofnone_of countcount_if	findfind_iffind_if_not find_end find_first_of	adjacent_find search search_n mismatch	equal for_each lexicographical_compare
Modifizierende Sequenzoperationen
copycopy_if copy_n copy_backward move move_backward	fill fill_n generate generate_n swap_ranges shuffle transform	removeremove_if replacereplace_if reverse rotate unique	remove_copyremove_copy_if replace_copyreplace_copy_if reverse_copy rotate_copy unique_copy
Partitionierungsoperationen
is_partitioned partition_point	partition partition_copy	stable_partition
Sortieroperationen
is_sorted is_sorted_until	sort stable_sort	partial_sort partial_sort_copy	nth_element
Binäre Suchoperationen
lower_bound	upper_bound	binary_search	equal_range
Mengenoperationen (auf sortierten Bereichen)
merge inplace_merge	includes	set_difference set_intersection	set_symmetric_difference set_union
Heapoperationen
is_heap is_heap_until	make_heap sort_heap	push_heap pop_heap
Minimum/Maximum-Operationen
max max_element	min min_element	minmax minmax_element
Permutationen
is_permutation	next_permutation	prev_permutation

 

Definiert in Header <experimental/ranges/algorithm>
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 Funktions-Objekt f für das Ergebnis der Auswertung des Projekters proj beim Dereferenzieren jedes Iterators im Bereich [first, last) auf (d.h. ranges::invoke(f, ranges::invoke(proj, *i))), in Reihenfolge.

2) Entspricht (1), verwendet aber r als Quellbereich, so als ob ranges::begin(r) als first und ranges::end(r) als last verwendet würden.

Bei beiden Überladungen gilt: Wenn der Iteratortyp veränderbar ist, kann f die Elemente des Bereichs über den dereferenzierten Iterator modifizieren. Wenn f ein Ergebnis zurückgibt, wird dieses ignoriert.

Im Gegensatz zu den übrigen Algorithmen darf for_each keine Kopien der Elemente in der Sequenz erstellen, selbst wenn diese trivial kopierbar sind.

Im Gegensatz zu std::for_each (das nur MoveConstructible erfordert), erfordern diese Funktionen, dass Fun CopyConstructible modelliert.

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

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 wird

Rückgabewert

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

• Der erste Member mit dem Tag tag::in ist der past-the-end-Iterator des Quellbereichs (d.h. ein Iterator vom Typ I, der gleich dem Sentinel last ist).
• Der zweite Member mit dem Tag tag::fun wird aus std::move(f) initialisiert (nach allen Anwendungen des Funktions-Objekts).

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)}; }

Siehe auch

transform	Wendet eine Funktion auf einen Elementbereich an (Funktionsvorlage)
Bereichs-for-Schleife(C++11)	führt Schleife über einen Bereich aus
for_each	wendet ein unäres Funktionsobjekt auf Elemente aus einem Bereich an (Funktion-Template)
for_each_n (C++17)	Wendet ein Funktionsobjekt auf die ersten N Elemente einer Sequenz an (Funktionstempelat)