Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::views::all — pohled na celý rozsah

std::views::all přizpůsobí rozsah rozhraní pohledu a zachová všechny jeho prvky. Výsledkem může být kopie nebo přesunutí existujícího pohledu, referenční pohled nebo vlastnický pohled; tato volba určuje, jak je třeba spravovat životnost dat.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

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

std::views::all z hlavičky <ranges> je objekt adaptér rozsahu. Výrazy std::views::all(r) a r | std::views::all vytvoří pohled na všechny prvky, aniž by jejich hodnoty filtrovaly nebo transformovaly. Argument musí splňovat std::ranges::viewable_range.

Výběr probíhá v pevném pořadí: pokud typ argumentu po odstranění referencí a kvalifikátorů modeluje std::ranges::view, je výsledkem objekt tohoto typu, zkopírovaný nebo přesunutý podle kategorie hodnoty. Jinak se vytvoří std::ranges::ref_view, pokud jej lze zkonstruovat; v opačném případě se vytvoří std::ranges::owning_view. Ne každý pohled lze předat jako l-hodnotu: pohled, který lze pouze přesouvat, může vyžadovat std::move.

U l-hodnoty std::vector<int> výsledek odkazuje na existující vektor; u dočasného std::vector<int> vektor vlastní. ref_view neprodlužuje životnost zdroje. Zdroj musí existovat po celou dobu používání pohledu a nadále platí pravidla kontejneru pro zneplatnění iterátorů. Při předání vektoru jako l-hodnoty all prvky nekopíruje. Při předání kopírovatelného pohledu jako l-hodnoty se naopak může zkopírovat jak samotný pohled, tak prvky, které uchovává: kopie std::ranges::single_view<int> uchovává vlastní int.

Příklad ukazuje oba případy: zápis přes borrowed změní values, zatímco owned ukládá vlastní vektor. Očekávaný výstup tvoří dva řádky obsahující 9. Repozitář používá příznak C++23; kompatibilita běhu v produkci nebyla potvrzena.

Pří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ýsledek

9
9

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje