WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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::all

std::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.

Quellen