CKTIS / C++
std::views::all — pogled na cijeli raspon
std::views::all prilagođava raspon sučelju pogleda i pritom zadržava sve njegove elemente. Rezultat može biti kopija ili premještanje postojećeg pogleda, referentni pogled ili pogled koji posjeduje raspon; taj izbor određuje kako treba upravljati životnim vijekom podataka.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <ranges>
std::views::all(r)
r | std::views::allstd::views::all iz zaglavlja <ranges> objekt je adaptera raspona. Izrazi std::views::all(r) i r | std::views::all stvaraju pogled na sve elemente, bez filtriranja ili pretvaranja njihovih vrijednosti. Argument mora zadovoljavati std::ranges::viewable_range.
Odabir slijedi fiksni redoslijed: ako tip argumenta nakon uklanjanja referenci i kvalifikatora modelira std::ranges::view, rezultat je objekt tog tipa, kopiran ili premješten ovisno o kategoriji vrijednosti. U suprotnom se stvara std::ranges::ref_view ako ga je moguće konstruirati; ako nije, stvara se std::ranges::owning_view. Ne može se svaki pogled proslijediti kao l-vrijednost: pogled koji se može samo premještati može zahtijevati std::move.
Za l-vrijednost std::vector<int> rezultat upućuje na postojeći vektor; za privremeni std::vector<int> preuzima vlasništvo nad vektorom. ref_view ne produljuje životni vijek izvora. Izvor mora postojati dok se pogled upotrebljava, a i dalje vrijede pravila spremnika o poništavanju iteratora. Kada se vektor proslijedi kao l-vrijednost, all ne kopira elemente. Ako se pak kao l-vrijednost proslijedi pogled koji se može kopirati, mogu se kopirati i sam pogled i elementi koje pohranjuje: kopija std::ranges::single_view<int> pohranjuje vlastiti int.
Primjer prikazuje oba slučaja: zapisivanjem kroz borrowed mijenja se values, dok owned pohranjuje vlastiti vektor. Očekivani izlaz čine dva retka koja sadrže 9. Repozitorij upotrebljava oznaku C++23; kompatibilnost izvođenja u produkciji nije potvrđena.
Primjeri
#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';
}
Rezultat
9 9
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.