CKTIS / C++
std::default_sentinel_t — eindmarkering van een bereik
std::default_sentinel_t is een leeg type voor een eindmarkering van een bereik uit <iterator>. Het werkt met iterators die zelf het einde kunnen bepalen, zoals std::counted_iterator. Het is geen universele vervanging voor end().
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iterator>
namespace std {
struct default_sentinel_t { };
inline constexpr default_sentinel_t default_sentinel{};
}std::default_sentinel_t, gedeclareerd in <iterator>, is een leeg type dat het einde van een bereik voorstelt. Het slaat geen eindadres en geen aantal elementen op. De bijbehorende iterator moet de informatie leveren die nodig is om het einde te herkennen.
Maak onderscheid tussen het type std::default_sentinel_t en het object std::default_sentinel. Dat laatste is gedeclareerd als inline constexpr default_sentinel_t default_sentinel{};. Je kunt het kant-en-klare object doorgeven of een waarde maken met std::default_sentinel_t{}. De declaraties in het syntaxveld beschrijven de bibliotheek; neem in je programma de header op in plaats van deze namen opnieuw te declareren in namespace std.
Een gebruikelijke partner is std::counted_iterator: die slaat een onderliggende iterator en het aantal resterende stappen op. Een vergelijking met deze sentinel is gelijk wanneer de teller nul is. De sentinel is geen iterator: je gebruikt hem niet voor dereferentie of incrementatie. Hij werkt ook niet automatisch met een gewone pointer of een willekeurige container-iterator — ondersteuning voor een geschikte vergelijking tussen iterator en sentinel is vereist.
In het voorbeeld beperkt de telling 3 de doorgang tot de eerste drie array-elementen, dus de verwachte uitvoer is 24 gevolgd door een regeleinde. De telling vervangt geen controles op de geldigheid van het bereik: zorg dat er genoeg elementen toegankelijk zijn en dereferenceer de iterator niet nadat het einde is bereikt.
Voorbeelden
#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';
}
Resultaat
24
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.