CKTIS / C++
std::views::all — pohled na celý rozsah
std::views::all přizpůsobí rozsah rozhraní pohledu a zachová všechny jeho prvky. Výsledkem může být kopie nebo přesunutí existujícího pohledu, referenční pohled nebo vlastnický pohled; tato volba určuje, jak je třeba spravovat životnost dat.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::views::all(r)
r | std::views::allstd::views::all z hlavičky <ranges> je objekt adaptér rozsahu. Výrazy std::views::all(r) a r | std::views::all vytvoří pohled na všechny prvky, aniž by jejich hodnoty filtrovaly nebo transformovaly. Argument musí splňovat std::ranges::viewable_range.
Výběr probíhá v pevném pořadí: pokud typ argumentu po odstranění referencí a kvalifikátorů modeluje std::ranges::view, je výsledkem objekt tohoto typu, zkopírovaný nebo přesunutý podle kategorie hodnoty. Jinak se vytvoří std::ranges::ref_view, pokud jej lze zkonstruovat; v opačném případě se vytvoří std::ranges::owning_view. Ne každý pohled lze předat jako l-hodnotu: pohled, který lze pouze přesouvat, může vyžadovat std::move.
U l-hodnoty std::vector<int> výsledek odkazuje na existující vektor; u dočasného std::vector<int> vektor vlastní. ref_view neprodlužuje životnost zdroje. Zdroj musí existovat po celou dobu používání pohledu a nadále platí pravidla kontejneru pro zneplatnění iterátorů. Při předání vektoru jako l-hodnoty all prvky nekopíruje. Při předání kopírovatelného pohledu jako l-hodnoty se naopak může zkopírovat jak samotný pohled, tak prvky, které uchovává: kopie std::ranges::single_view<int> uchovává vlastní int.
Příklad ukazuje oba případy: zápis přes borrowed změní values, zatímco owned ukládá vlastní vektor. Očekávaný výstup tvoří dva řádky obsahující 9. Repozitář používá příznak C++23; kompatibilita běhu v produkci nebyla potvrzena.
Příklady
#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';
}
Výsledek
9 9
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.