Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::views::all — vista dell’intero intervallo

std::views::all adatta un intervallo all’interfaccia delle viste mantenendone tutti gli elementi. Il risultato può essere una copia o uno spostamento di una vista esistente, una vista di riferimento oppure una vista proprietaria; da questa scelta dipende la gestione della durata dei dati.

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

Sintassi

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

std::views::all, dichiarato in <ranges>, è un oggetto adattatore di intervallo. Le espressioni std::views::all(r) e r | std::views::all producono una vista di tutti gli elementi, senza filtrarne né trasformarne i valori. L’argomento deve soddisfare std::ranges::viewable_range.

La selezione segue un ordine fisso: se il tipo dell’argomento, dopo aver rimosso riferimenti e qualificatori, modella std::ranges::view, il risultato è un oggetto di quel tipo, copiato o spostato in base alla categoria di valore. Altrimenti, viene prodotto std::ranges::ref_view se è possibile costruirlo; in caso contrario, viene prodotto std::ranges::owning_view. Non tutte le viste possono essere passate come lvalue: una vista spostabile ma non copiabile può richiedere std::move.

Per un lvalue std::vector<int>, il risultato fa riferimento al vettore esistente; per un std::vector<int> temporaneo, ne assume la proprietà. Un ref_view non prolunga la durata della sorgente. La sorgente deve restare in vita mentre si usa la vista e continuano ad applicarsi le regole di invalidamento degli iteratori del contenitore. Quando il vettore è passato come lvalue, all non copia gli elementi. Passare come lvalue una vista copiabile può invece comportare la copia sia della vista sia degli elementi che memorizza: una copia di std::ranges::single_view<int> memorizza un proprio int.

L’esempio mostra entrambi i casi: una scrittura tramite borrowed modifica values, mentre owned memorizza il proprio vettore. L’output previsto è composto da due righe contenenti 9. Il repository usa l’opzione C++23; la compatibilità di esecuzione in produzione non è attestata.

Esempi

#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';
}

Risultato

9
9

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti