CKTIS / C++
std::views::all — Ansicht des gesamten Bereichs
std::views::all passt einen Bereich an die View-Schnittstelle an und behält dabei alle Elemente bei. Das Ergebnis kann eine Kopie oder Verschiebung einer vorhandenen View, eine Referenz-View oder eine besitzende View sein; davon hängt ab, wie die Lebensdauer der Daten verwaltet werden muss.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::views::all(r)
r | std::views::allstd::views::all aus <ranges> ist ein Range-Adaptor-Objekt. Die Ausdrücke std::views::all(r) und r | std::views::all erzeugen eine View aller Elemente, ohne ihre Werte zu filtern oder umzuwandeln. Das Argument muss std::ranges::viewable_range erfüllen.
Die Auswahl folgt einer festen Reihenfolge: Modelliert der Argumenttyp nach dem Entfernen von Referenzen und Qualifizierern std::ranges::view, ist das Ergebnis ein Objekt dieses Typs, das entsprechend der Wertkategorie kopiert oder verschoben wird. Andernfalls wird std::ranges::ref_view erzeugt, sofern es konstruiert werden kann; falls nicht, entsteht std::ranges::owning_view. Nicht jede View kann als L-Wert übergeben werden: Für eine nur verschiebbare View kann std::move erforderlich sein.
Bei einem L-Wert vom Typ std::vector<int> verweist das Ergebnis auf den vorhandenen Vektor; bei einem temporären std::vector<int> übernimmt es den Besitz des Vektors. Eine ref_view verlängert die Lebensdauer der Quelle nicht. Die Quelle muss während der Verwendung der View weiterhin existieren, und die Regeln zur Iteratorinvalidierung des Containers gelten weiterhin. Wird der Vektor als L-Wert übergeben, kopiert all die Elemente nicht. Wird dagegen eine kopierbare View als L-Wert übergeben, können sowohl die View als auch die darin gespeicherten Elemente kopiert werden: Eine Kopie von std::ranges::single_view<int> speichert einen eigenen int.
Das Beispiel zeigt beide Fälle: Eine Änderung über borrowed verändert values, während owned seinen eigenen Vektor speichert. Die erwartete Ausgabe besteht aus zwei Zeilen mit jeweils 9. Das Repository verwendet das C++23-Flag; die Laufzeitkompatibilität in der Produktionsumgebung wurde nicht bestätigt.
Beispiele
#include <iostream>
#include <ranges>
#include <type_traits>
#include <vector>
int main() {
std::vector<int> values{1, 2, 3};
auto borrowed = values | std::views::all;
auto owned = std::views::all(std::vector<int>{4, 5});
static_assert(std::is_same_v<decltype(borrowed),
std::ranges::ref_view<std::vector<int>>>);
static_assert(std::is_same_v<decltype(owned),
std::ranges::owning_view<std::vector<int>>>);
borrowed.front() = 9;
std::cout << values.front() << '\n';
int sum = 0;
for (int value : owned) {
sum += value;
}
std::cout << sum << '\n';
}
Ergebnis
9 9
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.