Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje