CKTIS / C++
std::views::all — pohľad na celý rozsah
std::views::all prispôsobí rozsah rozhraniu pohľadu a zachová všetky jeho prvky. Výsledkom môže byť kópia alebo presunutie existujúceho pohľadu, referenčný pohľad alebo vlastniaci pohľad; táto voľba určuje, ako treba spravovať životnosť údajov.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::views::all(r)
r | std::views::allstd::views::all z hlavičky <ranges> je objekt adaptéra rozsahu. Výrazy std::views::all(r) a r | std::views::all vytvoria pohľad na všetky prvky bez filtrovania alebo transformácie ich hodnôt. Argument musí spĺňať std::ranges::viewable_range.
Výber prebieha v pevnom poradí: ak typ argumentu po odstránení referencií a kvalifikátorov modeluje std::ranges::view, výsledkom je objekt tohto typu, skopírovaný alebo presunutý podľa kategórie hodnoty. Inak sa vytvorí std::ranges::ref_view, ak sa dá skonštruovať; ak nie, vytvorí sa std::ranges::owning_view. Nie každý pohľad možno odovzdať ako l-hodnotu: pohľad, ktorý možno iba presúvať, môže vyžadovať std::move.
Pri l-hodnote std::vector<int> výsledok odkazuje na existujúci vektor; pri dočasnom std::vector<int> prevezme vlastníctvo vektora. ref_view nepredlžuje životnosť zdroja. Zdroj musí existovať počas používania pohľadu a naďalej platia pravidlá kontajnera pre zneplatnenie iterátorov. Keď sa vektor odovzdá ako l-hodnota, all prvky nekopíruje. Pri odovzdaní kopírovateľného pohľadu ako l-hodnoty sa však môže skopírovať samotný pohľad aj prvky, ktoré uchováva: kópia std::ranges::single_view<int> uchováva vlastný int.
Príklad ukazuje oba prípady: zápis cez borrowed zmení values, zatiaľ čo owned uchováva vlastný vektor. Očakávaný výstup tvoria dva riadky obsahujúce 9. Úložisko používa príznak C++23; kompatibilita behu v produkcii nebola potvrdená.
Prí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ýsledok
9 9
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.