Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::views::all — widok całego zakresu

std::views::all dostosowuje zakres do interfejsu widoku, zachowując wszystkie elementy. Wynik może być kopią lub przeniesieniem istniejącego widoku, widokiem referencyjnym albo widokiem posiadającym zakres; wybór wpływa na czas życia danych.

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

Składnia

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

std::views::all z nagłówka <ranges> jest obiektem adaptora zakresu. Wyrażenia std::views::all(r) i r | std::views::all tworzą widok wszystkich elementów, bez filtrowania ani przekształcania ich wartości. Argument musi spełniać wymagania std::ranges::viewable_range.

Wybór wyniku ma określoną kolejność: jeżeli typ argumentu po usunięciu referencji i kwalifikatorów modeluje std::ranges::view, wynik jest obiektem tego typu, kopiowanym lub przenoszonym zgodnie z kategorią wartości. W przeciwnym razie powstaje std::ranges::ref_view, jeśli można go skonstruować; w pozostałym przypadku powstaje std::ranges::owning_view. Nie każdy widok można przekazać jako l-wartość: widok tylko przenoszalny może wymagać std::move.

Dla l-wartości std::vector<int> wynik odwołuje się do istniejącego wektora; dla tymczasowego std::vector<int> przejmuje wektor na własność. ref_view nie przedłuża czasu życia źródła. Źródło musi nadal istnieć podczas używania widoku, a reguły unieważniania iteratorów kontenera nadal obowiązują. W przypadku wektora przekazanego jako l-wartość all nie kopiuje elementów. Natomiast przekazanie kopiowalnego widoku jako l-wartości może spowodować skopiowanie zarówno widoku, jak i przechowywanych w nim elementów: kopia std::ranges::single_view<int> przechowuje własny int.

Przykład pokazuje oba warianty: zapis przez borrowed zmienia values, natomiast owned przechowuje własny wektor. Oczekiwane wyjście to dwie linie zawierające 9. Repozytorium używa flagi C++23; zgodność środowiska produkcyjnego nie została potwierdzona.

Przykłady

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

Wynik

9
9

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła