std::experimental::ranges::search

 

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< ForwardIterator I1, Sentinel<I1> S1,           ForwardIterator I2, Sentinel<I2> S2, class Pred = ranges::equal_to<>,           class Proj1 = ranges::identity, class Proj2 = ranges::identity >     requires IndirectlyComparable<I1, I2, Pred, Proj1, Proj2> I1 search( I1 first1, S1 last1, I2 first2, S2 last2,            Pred pred = Pred{}, Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} );	(1)	(Ranges TS)
template< ForwardRange R1, ForwardRange R2, class Pred = ranges::equal_to<>,           class Proj1 = ranges::identity, class Proj2 = ranges::identity >     requires IndirectlyComparable<ranges::iterator_t<R1>, ranges::iterator_t<R2>,                                   Pred, Proj1, Proj2> ranges::safe_iterator_t<R1> search( R1&& r1, R2&& r2, Pred pred = Pred{},                                     Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} );	(2)	(Ranges TS)

1) Sucht nach dem ersten Vorkommen der Sequenz von Elementen [first2, last2) im Bereich [first1, last1). Elemente werden mittels pred verglichen, nachdem sie mit proj2 bzw. proj1 projiziert wurden.

2) Wie (1), verwendet aber r1 als ersten Quellbereich und r2 als zweiten Quellbereich, als ob ranges::begin(r1) als first1, ranges::end(r1) als last1, ranges::begin(r2) als first2 und ranges::end(r2) als last2 verwendet würden.

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

first1, last1	-	der Bereich der zu untersuchenden Elemente
r1	-	der Bereich der zu untersuchenden Elemente
first2, last2	-	der Bereich der zu durchsuchenden Elemente
r2	-	der Bereich der zu durchsuchenden Elemente
pred	-	Prädikat, das auf die projizierten Elemente angewendet wird
proj1	-	Projektion, die auf die Elemente im ersten Bereich angewendet wird
proj2	-	Projektion, die auf die Elemente im zweiten Bereich angewendet wird

Rückgabewert

Ein Iterator auf den Anfang des ersten Vorkommens der Sequenz [first2, last2) im Bereich [first1, last1). Wenn [first2, last2) leer ist, wird first1 zurückgegeben. Wenn kein solches Vorkommen gefunden wird, wird ein Iterator zurückgegeben, der gleich last1 ist.

Komplexität

Höchstens S * N Anwendungen des Prädikats und jeder Projektion, wobei S = last2 - first2 und N = last1 - first1.

Mögliche Implementierung

template<ForwardIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2, class Pred = ranges::equal_to<>, class Proj1 = ranges::identity, class Proj2 = ranges::identity> requires IndirectlyComparable<I1, I2, Pred, Proj1, Proj2> I1 search(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{}, Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{}) { for (; ; ++first1) { I1 it = first1; for (I2 it2 = first2; ; (void)++it, (void)++it2) { if (it2 == last2) return first1; if (it == last1) return it; if (!ranges::invoke(pred, ranges::invoke(proj1, *it), ranges::invoke(proj2, *it2))) break; } } }

Siehe auch

search	Sucht nach dem ersten Vorkommen eines Elementbereichs (Funktionstempelat)
find_end	Findet die letzte Sequenz von Elementen in einem bestimmten Bereich (Funktionsvorlage)
includes	gibt true zurück, wenn eine Menge eine Teilmenge einer anderen ist (Funktionsvorlage)
equal	Bestimmt, ob zwei Elementmengen gleich sind (Funktionsvorlage)
findfind_iffind_if_not	Findet das erste Element, das bestimmte Kriterien erfüllt (Funktionsvorlage)
lexicographical_compare	gibt true zurück, wenn ein Bereich lexikographisch kleiner als ein anderer ist (Funktionsvorlage)
mismatch	Findet die erste Position, an der sich zwei Bereiche unterscheiden (Funktionsvorlage)
search_n	sucht nach einer Anzahl aufeinanderfolgender Kopien eines Elements in einem Bereich (Funktionsvorlage)