Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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::all

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

Zdroje