Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::views::all — pogled na celoten obseg

std::views::all prilagodi obseg vmesniku pogleda in ohrani vse njegove elemente. Rezultat je lahko kopija ali premik obstoječega pogleda, referenčni pogled ali lastniški pogled; od te izbire je odvisno upravljanje življenjske dobe podatkov.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <ranges>
std::views::all(r)
r | std::views::all

std::views::all iz glave <ranges> je objekt adapterja obsegov. Izraza std::views::all(r) in r | std::views::all ustvarita pogled na vse elemente, ne da bi filtrirala ali spreminjala njihove vrednosti. Argument mora izpolnjevati std::ranges::viewable_range.

Izbira sledi določenemu vrstnemu redu: če tip argumenta po odstranitvi referenc in kvalifikatorjev modelira std::ranges::view, je rezultat objekt tega tipa, kopiran ali premaknjen glede na kategorijo vrednosti. Sicer se ustvari std::ranges::ref_view, če ga je mogoče skonstruirati; v nasprotnem primeru se ustvari std::ranges::owning_view. Vsakega pogleda ni mogoče podati kot levo vrednost: pogled, ki ga je mogoče samo premakniti, lahko zahteva std::move.

Pri levi vrednosti std::vector<int> se rezultat sklicuje na obstoječi vektor; pri začasnem std::vector<int> prevzame lastništvo vektorja. ref_view ne podaljša življenjske dobe vira. Vir mora obstajati, dokler se pogled uporablja, še naprej pa veljajo pravila vsebnika za razveljavitev iteratorjev. Če vektor podamo kot levo vrednost, all ne kopira elementov. Če pa kot levo vrednost podamo pogled, ki ga je mogoče kopirati, se lahko kopirajo tako pogled kot elementi, ki jih hrani: kopija std::ranges::single_view<int> hrani lasten int.

Primer prikazuje oba primera: pisanje prek borrowed spremeni values, medtem ko owned hrani svoj vektor. Pričakovani izpis sta dve vrstici z 9. Repozitorij uporablja zastavico C++23; združljivost izvajanja v produkciji ni potrjena.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri