CKTIS / C++
std::default_sentinel_t — značka konce rozsahu
std::default_sentinel_t je prázdný typ značky konce rozsahu z hlavičky <iterator>. Funguje s iterátory, které dokážou konec určit samy, například std::counted_iterator. Není univerzální náhradou za end().
Verze: 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, deklarovaný v <iterator>, je prázdný typ představující konec rozsahu. Neukládá adresu konce ani počet prvků. Potřebné informace k rozpoznání konce musí poskytovat spolupracující iterátor.
Rozlišujte typ std::default_sentinel_t a objekt std::default_sentinel. Ten je deklarován jako inline constexpr default_sentinel_t default_sentinel{};. Můžete předat hotový objekt nebo vytvořit hodnotu pomocí std::default_sentinel_t{}. Deklarace v poli syntaxe popisují knihovnu; ve svém programu vložte hlavičku, místo abyste tato jména znovu deklarovali v namespace std.
Typickým partnerem je std::counted_iterator: ukládá podkladový iterátor a počet zbývajících kroků. Porovnání s touto značkou je rovno, když je počitadlo nulové. Značka není iterátor: neslouží k dereferencování ani inkrementaci. Automaticky nefunguje ani s běžným ukazatelem nebo libovolným iterátorem kontejneru — je nutná podpora vhodného porovnání iterátoru se značkou.
V příkladu počitadlo 3 omezuje průchod na první tři prvky pole, takže očekávaný výstup je 24 následované znakem nového řádku. Počitadlo nenahrazuje kontrolu platnosti rozsahu: zajistěte, aby bylo dostupných dost prvků, a po dosažení konce iterátor nedereferencujte.
Příklady
#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';
}
Výsledek
24
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.