Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

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

Izvori