CKTIS / C++
std::ranges::subrange — une vue d’itérateur et de sentinelle
std::ranges::subrange, défini dans <ranges>, associe un itérateur de début et une sentinelle de fin pour former une vue de [first, last). Il ne copie pas les éléments dans un nouveau conteneur et permet de transmettre une portion choisie des données comme un seul objet.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();std::ranges::subrange<I, S, K> stocke un itérateur et une sentinelle pour former une vue de [first, last) : le début est inclus et la fin est exclue. Les types I et S peuvent différer ; le stockage n’a pas besoin d’être contigu. Incluez <ranges>. La construction de std::ranges::subrange(first, last) permet de déduire les arguments du modèle.
std::ranges::subrange::begin renvoie une copie de l’itérateur stocké lorsque I satisfait copyable. Sinon, seule la surcharge non-const est disponible et elle déplace l’itérateur stocké ; dans ce cas, ne supposez pas que des appels répétés reproduiront le même début. std::ranges::subrange::end renvoie une copie de la sentinelle. Comparez un itérateur à end() avant de le déréférencer ; la sentinelle elle-même n’a pas besoin de permettre le déréférencement.
K sélectionne subrange_kind::sized ou subrange_kind::unsized. Seule la variante sized fournit size() : elle calcule le résultat en soustrayant les extrémités ou stocke une taille lorsque cette soustraction n’est pas disponible. Le constructeur qui prend l’argument n exige que n soit égal à la longueur réelle de la plage valide [first, last).
La vue ne copie pas les éléments et ne prolonge pas à elle seule la durée de vie des données. Ne l’utilisez pas après la destruction des données ou l’invalidation de ses itérateurs. Une modification effectuée par un itérateur modifiable change les données d’origine ; rendre la vue elle-même const ne rend pas ses éléments constants.
L’exemple porte sur values[1], values[2] et values[3]. Après avoir remplacé le premier par 21, il affiche exactement sum=91 et values[1]=21, chacun sur sa propre ligne. Portée des informations d’environnement : C++23 ; option du compilateur du dépôt, compatibilité avec l’environnement de production non attestée. La norme en ligne est un projet en évolution, et non une publication C++23 figée.
Exemples
#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';
}
Résultat
sum=91 values[1]=21
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.