CKTIS / C++
std::span — una vista su elementi contigui
std::span consente di accedere a elementi contigui senza possederli. Permette di passare un intervallo insieme alla sua dimensione, mentre subspan crea una vista di una parte dell’intervallo senza copiare gli elementi.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <span>
// Default construction is allowed only for extent 0 or std::dynamic_extent.
std::span<T> empty; // Extent defaults to std::dynamic_extent.
std::span<T> view{data, count};
view.size();
view.subspan(offset, count);
view.subspan<Offset, Count>();std::span<T, Extent> di <span> è una vista su elementi contigui. Non possiede tali elementi e non ne prolunga la durata. Extent specifica una dimensione fissa nel tipo; il valore predefinito std::dynamic_extent, come in std::span<T>, indica che la dimensione viene determinata a runtime.
std::span::size() restituisce il numero di elementi come size_type, non il numero di byte. std::span::subspan(offset, count) crea una vista a partire dall’indice offset, senza copiare i dati. Se count viene omesso o se si passa esplicitamente std::dynamic_extent, la vista copre la parte restante dell’intervallo. Altrimenti copre count elementi. Questo overload restituisce una vista di dimensione dinamica. subspan<Offset, Count>() accetta argomenti di template. Se Count != std::dynamic_extent, il risultato ha estensione fissa pari a Count. Se Count == std::dynamic_extent, sia che il valore venga specificato esplicitamente sia che si usi quello predefinito, l’estensione del risultato è dinamica quando Extent == std::dynamic_extent; altrimenti è fissa e vale Extent - Offset.
In C++23 è richiesto offset <= size() e, per un count esplicito diverso da std::dynamic_extent, anche count <= size() - offset. La violazione di queste condizioni causa comportamento indefinito, non un’eccezione garantita. L’overload di template rifiuta inoltre limiti incompatibili con l’estensione codificata nel tipo. size() e subspan() hanno complessità temporale costante.
I dati devono rimanere validi mentre la vista viene usata; la distruzione del proprietario o la riallocazione della sua memoria può invalidare l’accesso. std::span<const T> impedisce di modificare gli elementi attraverso la vista, mentre const std::span<T> non lo fa. L’esempio modifica l’array originale tramite una sottovista. La fonte è una bozza di standard in evoluzione, quindi la descrizione si limita intenzionalmente alle operazioni disponibili in C++23.
Esempi
#include <iostream>
#include <span>
int main() {
int values[]{10, 20, 30, 40};
std::span<int> all{values};
auto middle = all.subspan(1, 2);
middle[0] = 25;
std::cout << all.size() << ' ' << middle.size() << '\n';
std::cout << values[1] << ' ' << middle[1] << '\n';
}
Risultato
4 2 25 30
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.