KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::views::all — een view van een volledig bereik

std::views::all past een bereik aan de view-interface aan en behoudt alle elementen. Het resultaat kan een kopie of verplaatsing van een bestaande view zijn, een referentieview of een bezittende view; die keuze bepaalt hoe de levensduur van de gegevens moet worden beheerd.

Versie: C++23; repository compiler flag, production runtime not attested

Syntax

#include <ranges>
std::views::all(r)
r | std::views::all

std::views::all, gedeclareerd in <ranges>, is een range-adaptorobject. De expressies std::views::all(r) en r | std::views::all leveren een view van alle elementen op, zonder hun waarden te filteren of te transformeren. Het argument moet voldoen aan std::ranges::viewable_range.

De keuze volgt een vaste volgorde: als het type van het argument, na verwijdering van referenties en kwalificaties, std::ranges::view modelleert, is het resultaat een object van dat type, gekopieerd of verplaatst volgens de waardecategorie. Anders wordt std::ranges::ref_view gemaakt als dat kan worden geconstrueerd; zo niet, dan wordt std::ranges::owning_view gemaakt. Niet elke view kan als lvalue worden doorgegeven: voor een view die alleen verplaatsbaar is, kan std::move nodig zijn.

Bij een lvalue std::vector<int> verwijst het resultaat naar de bestaande vector; bij een tijdelijke std::vector<int> neemt het de vector in bezit. Een ref_view verlengt de levensduur van de bron niet. De bron moet blijven bestaan zolang de view wordt gebruikt, en de regels voor iteratorinvalidatie van de container blijven van toepassing. Als de vector als lvalue wordt doorgegeven, kopieert all de elementen niet. Geef je daarentegen een kopieerbare view als lvalue door, dan kunnen zowel de view als de daarin opgeslagen elementen worden gekopieerd: een kopie van std::ranges::single_view<int> slaat een eigen int op.

Het voorbeeld laat beide gevallen zien: schrijven via borrowed verandert values, terwijl owned een eigen vector opslaat. De verwachte uitvoer bestaat uit twee regels met 9. De repository gebruikt de C++23-optie; compatibiliteit tijdens uitvoering in productie is niet bevestigd.

Voorbeelden

#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';
}

Resultaat

9
9

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen