CKTIS / C++
std::views::take_while — ein Präfix, das eine Bedingung erfüllt
std::views::take_while erstellt eine verzögerte Ansicht der anfänglichen Bereichselemente, die ein Prädikat erfüllen. Sie endet vor dem ersten Element, das die Bedingung nicht erfüllt, und sucht danach nicht weiter nach passenden Elementen.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
std::views::take_while(range, pred)
range | std::views::take_while(pred)std::views::take_while ist ein Range-Adapter, der eine std::ranges::take_while_view erstellt. Verwende std::views::take_while(range, pred) oder range | std::views::take_while(pred). Die Ansicht umfasst aufeinanderfolgende Elemente vom Anfang bis zum ersten Ergebnis false, schließt also das Element aus, das dieses Ergebnis verursacht hat. Erfüllt bereits das erste Element die Bedingung nicht, ist das Ergebnis leer; erfüllen alle Elemente die Bedingung, umfasst die Ansicht den gesamten Bereich.
Die Ansicht ist verzögert: Bei ihrer Erstellung wird kein separater Ergebniskontainer aufgebaut. Die Bedingung wird während der Iteration geprüft, wenn der Iterator mit dem End-Sentinel verglichen wird. Gehe weder von genau einem Prädikataufruf pro Element aus, noch mache das Ergebnis von einem Aufrufzähler abhängig. Das Prädikat muss indirect_unary_predicate<const Pred, iterator_t<V>> erfüllen, und die zugrunde liegende Ansicht V muss input_range erfüllen.
Im Beispiel lässt x < 5 die Werte 2 und 4 durch; 7 beendet die Ansicht. Die späteren Werte 1 und 3 sind nicht enthalten: Es wird ein Präfix ausgewählt, nicht jedes passende Element. Das Array values muss während der Verwendung der darauf verweisenden Ansicht gültig bleiben.
Bei einer Eingabe mit nur einem Durchlauf, etwa einem Stream, kann das Erkennen des Abbruchelements dieses bereits aus der Quelle lesen. Gehe daher nicht davon aus, dass es für die nächste Stream-Extraktion noch verfügbar ist.
Beispiele
#include <iostream>
#include <ranges>
int main() {
int values[] = {2, 4, 7, 1, 3};
auto prefix = values | std::views::take_while([](int x) {
return x < 5;
});
bool first = true;
for (int x : prefix) {
if (!first) std::cout << ' ';
std::cout << x;
first = false;
}
std::cout << '\n';
}
Ergebnis
2 4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.