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