CKTIS / C++
std::default_sentinel_t — marqueur de fin de plage
std::default_sentinel_t est un type vide servant de marqueur de fin de plage, défini dans <iterator>. Il fonctionne avec les itérateurs capables de déterminer eux-mêmes la fin, comme std::counted_iterator. Ce n’est pas un remplacement universel de end().
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <iterator>
namespace std {
struct default_sentinel_t { };
inline constexpr default_sentinel_t default_sentinel{};
}std::default_sentinel_t, déclaré dans <iterator>, est un type vide qui représente la fin d’une plage. Il ne stocke ni adresse de fin ni nombre d’éléments. L’itérateur associé doit fournir les informations nécessaires pour reconnaître la fin.
Il faut distinguer le type std::default_sentinel_t de l’objet std::default_sentinel. Ce dernier est déclaré ainsi : inline constexpr default_sentinel_t default_sentinel{};. Vous pouvez passer l’objet prêt à l’emploi ou construire une valeur avec std::default_sentinel_t{}. Les déclarations du champ de syntaxe décrivent la bibliothèque ; dans votre programme, incluez l’en-tête au lieu de redéclarer ces noms dans namespace std.
Un partenaire courant est std::counted_iterator : il stocke un itérateur sous-jacent et le nombre d’étapes restantes. La comparaison avec ce marqueur indique l’égalité lorsque le compteur vaut zéro. Le marqueur n’est pas un itérateur : il ne sert ni à la déréférence ni à l’incrémentation. Il ne fonctionne pas non plus automatiquement avec un pointeur ordinaire ou un itérateur de conteneur quelconque — une prise en charge adaptée de la comparaison itérateur-marqueur est nécessaire.
Dans l’exemple, le compte 3 limite le parcours aux trois premiers éléments du tableau ; la sortie attendue est donc 24 suivi d’un saut de ligne. Le compte ne remplace pas la vérification de validité de la plage : assurez-vous que suffisamment d’éléments sont accessibles et ne déréférencez pas l’itérateur après avoir atteint la fin.
Exemples
#include <iostream>
#include <iterator>
int main() {
int values[] = {4, 8, 12, 16};
auto it = std::counted_iterator(values, 3);
const std::default_sentinel_t end = std::default_sentinel;
int sum = 0;
for (; it != end; ++it) {
sum += *it;
}
std::cout << sum << '\n';
}
Résultat
24
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.