CKTIS / C++
std::default_sentinel_t — Endmarkierung eines Bereichs
std::default_sentinel_t ist ein leerer Typ für eine Endmarkierung aus <iterator>. Er funktioniert mit Iteratoren, die das Ende selbst erkennen können, etwa std::counted_iterator. Er ist kein universeller Ersatz für end().
Version: 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, deklariert in <iterator>, ist ein leerer Typ, der das Ende eines Bereichs darstellt. Er speichert weder eine Endadresse noch die Anzahl der Elemente. Der zugehörige Iterator muss die Informationen liefern, die zum Erkennen des Endes nötig sind.
Unterscheide den Typ std::default_sentinel_t vom Objekt std::default_sentinel. Letzteres ist als inline constexpr default_sentinel_t default_sentinel{}; deklariert. Du kannst das bereitgestellte Objekt übergeben oder mit std::default_sentinel_t{} einen Wert erzeugen. Die Deklarationen im Syntaxfeld beschreiben die Bibliothek; binde in deinem Programm den Header ein, statt diese Namen erneut in namespace std zu deklarieren.
Ein typischer Partner ist std::counted_iterator: Er speichert einen zugrunde liegenden Iterator und die Anzahl der verbleibenden Schritte. Beim Vergleich mit dieser Endmarkierung ergibt sich Gleichheit, wenn der Zähler null ist. Die Endmarkierung ist kein Iterator: Sie wird weder dereferenziert noch inkrementiert. Sie funktioniert auch nicht automatisch mit einem gewöhnlichen Zeiger oder einem beliebigen Container-Iterator — dafür muss ein geeigneter Vergleich zwischen Iterator und Endmarkierung unterstützt werden.
Im Beispiel begrenzt der Zähler 3 den Durchlauf auf die ersten drei Array-Elemente; die erwartete Ausgabe ist daher 24 gefolgt von einem Zeilenumbruch. Der Zähler ersetzt keine Prüfung der Bereichsgültigkeit: Stelle sicher, dass genügend Elemente zugänglich sind, und dereferenziere den Iterator nicht, nachdem das Ende erreicht wurde.
Beispiele
#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';
}
Ergebnis
24
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.