CKTIS / C++
std::span — une vue sur des éléments contigus
std::span donne accès à des éléments contigus sans en être propriétaire. Il permet de transmettre une plage avec sa taille, tandis que subspan crée une vue sur une partie de cette plage sans copier les éléments.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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> de <span> est une vue sur des éléments contigus. Elle ne possède pas ces éléments et ne prolonge pas leur durée de vie. Extent spécifie une taille fixe dans le type ; la valeur par défaut std::dynamic_extent, comme dans std::span<T>, signifie que la taille est déterminée à l’exécution.
std::span::size() renvoie le nombre d’éléments sous forme de size_type, et non le nombre d’octets. std::span::subspan(offset, count) crée une vue à partir de l’indice offset, sans copier les données. Si count est omis ou si std::dynamic_extent est passé explicitement, la vue couvre le reste de la plage. Sinon, elle couvre count éléments. Cette surcharge renvoie une vue de taille dynamique. subspan<Offset, Count>() prend des arguments de modèle. Si Count != std::dynamic_extent, le résultat a pour étendue fixe Count. Si Count == std::dynamic_extent, que cette valeur soit fournie explicitement ou utilisée par défaut, l’étendue du résultat est dynamique lorsque Extent == std::dynamic_extent ; sinon, elle est fixe et vaut Extent - Offset.
En C++23, offset <= size() est requis et, pour un count explicite différent de std::dynamic_extent, count <= size() - offset l’est également. Le non-respect de ces conditions entraîne un comportement indéfini, et non une exception garantie. La surcharge de modèle rejette aussi les limites incompatibles avec l’étendue encodée dans le type. size() et subspan() ont une complexité en temps constante.
Les données doivent rester valides pendant l’utilisation de la vue ; la destruction du propriétaire ou la réallocation de son stockage peut rendre l’accès invalide. std::span<const T> empêche de modifier les éléments par l’intermédiaire de la vue, contrairement à const std::span<T>. L’exemple modifie le tableau d’origine par l’intermédiaire d’une sous-vue. La source est un projet de norme en évolution ; cette description se limite donc volontairement aux opérations disponibles en C++23.
Exemples
#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';
}
Résultat
4 2 25 30
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.