Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ranges::to — creare un contenitore da un range

C++23 std::ranges::to crea un oggetto, di solito un contenitore, a partire da un range di input. Consente di terminare una pipeline di viste con un risultato concreto, specificando il tipo completo del contenitore oppure un template di cui verranno dedotti gli argomenti.

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

Sintassi

std::ranges::to<C>(range, args...)
range | std::ranges::to<C>(args...)
std::ranges::to<ContainerTemplate>(range, args...)
range | std::ranges::to<ContainerTemplate>(args...)

std::ranges::to, disponibile da C++23 in <ranges>, crea un risultato da un range che soddisfa input_range. Per un contenitore come std::vector<int>, materializza gli elementi invece di creare un’altra vista lazy. Il tipo di destinazione C deve essere un tipo classe senza qualificatori cv e non deve soddisfare view.

L’espressione std::ranges::to<std::vector<int>>(range) specifica esplicitamente il tipo del risultato. La forma std::ranges::to<std::vector>(range) usa la deduzione degli argomenti del template di classe. In una pipeline, usa range | std::ranges::to<std::vector<int>>(): le () creano un oggetto di chiusura della pipeline. Gli args... aggiuntivi, per esempio un allocatore, vengono inoltrati al costruttore del contenitore selezionato.

Per gli elementi convertibili direttamente, la funzione prova, nell’ordine: un costruttore che accetta il range, un costruttore contrassegnato con std::from_range, un costruttore appropriato che accetta una coppia di iteratori e, infine, la costruzione con args... seguita dall’inserimento degli elementi. Ogni percorso ha requisiti specifici. I range annidati possono essere convertiti ricorsivamente; se non è applicabile alcun percorso consentito, il programma è mal formato.

L’esempio crea uno std::vector<int> contenente i quadrati da 1 a 5; il limite superiore di std::views::iota(1, 6) è escluso. La materializzazione di questa pipeline attraversa i suoi elementi, quindi non usare un range illimitato senza limitare il numero di elementi. È necessaria un’implementazione della libreria che supporti questa funzionalità C++23: il solo flag del compilatore del repository non attesta il supporto nell’ambiente di produzione. Il riferimento fornito è una bozza di standard in evoluzione, non un’edizione C++23 definitiva.

Esempi

#include <cstddef>
#include <iostream>
#include <ranges>
#include <vector>

int main() {
    auto values = std::views::iota(1, 6)
        | std::views::transform([](int n) { return n * n; })
        | std::ranges::to<std::vector<int>>();

    for (std::size_t i = 0; i < values.size(); ++i) {
        if (i != 0) std::cout << ' ';
        std::cout << values[i];
    }
    std::cout << '\n';
}

Risultato

1 4 9 16 25

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