Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ranges::subrange — una vista di iteratore e sentinella

std::ranges::subrange di <ranges> combina un iteratore iniziale e una sentinella finale per formare una vista di [first, last). Non copia gli elementi in un nuovo contenitore: permette di passare una porzione selezionata dei dati come un unico oggetto.

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

Sintassi

#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();

std::ranges::subrange<I, S, K> memorizza un iteratore e una sentinella formando una vista di [first, last): l’inizio è incluso e la fine è esclusa. I tipi I e S possono essere diversi; la memoria non deve essere contigua. Includi <ranges>. La costruzione di std::ranges::subrange(first, last) consente di dedurre gli argomenti del modello.

std::ranges::subrange::begin restituisce una copia dell’iteratore memorizzato quando I soddisfa copyable. Altrimenti è disponibile solo l’overload non-const, che sposta l’iteratore memorizzato; in questo caso non presumere che chiamate ripetute restituiscano lo stesso inizio. std::ranges::subrange::end restituisce una copia della sentinella. Confronta un iteratore con end() prima di dereferenziarlo; la sentinella stessa non deve necessariamente supportare la dereferenziazione.

K seleziona subrange_kind::sized o subrange_kind::unsized. Solo la variante sized fornisce size(): calcola il risultato sottraendo gli estremi oppure memorizza una dimensione quando tale sottrazione non è disponibile. Il costruttore che accetta l’argomento n richiede che n corrisponda alla lunghezza effettiva dell’intervallo valido [first, last).

La vista non copia gli elementi né prolunga da sola la durata dei dati. Non usarla dopo che i dati sono stati distrutti o i suoi iteratori sono stati invalidati. Una modifica tramite un iteratore scrivibile cambia i dati originali; rendere const la vista stessa non rende costanti i suoi elementi.

L’esempio comprende values[1], values[2] e values[3]. Dopo aver modificato il primo di questi elementi in 21, stampa esattamente sum=91 e values[1]=21, ciascuno su una riga separata. Ambito delle informazioni sull’ambiente: C++23; flag del compilatore del repository, compatibilità dell’ambiente di produzione non attestata. Lo standard online è una bozza in evoluzione, non una pubblicazione C++23 congelata.

Esempi

#include <iostream>
#include <ranges>

int main() {
    int values[] = {10, 20, 30, 40, 50};
    auto middle = std::ranges::subrange(values + 1, values + 4);

    *middle.begin() = 21;
    int sum = 0;
    for (auto it = middle.begin(); it != middle.end(); ++it) {
        sum += *it;
    }

    std::cout << "sum=" << sum << '\n';
    std::cout << "values[1]=" << values[1] << '\n';
}

Risultato

sum=91
values[1]=21

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