CKTIS / C++
std::default_sentinel_t — znacznik końca zakresu
std::default_sentinel_t to pusty typ znacznika końca zakresu z nagłówka <iterator>. Współpracuje z iteratorami, które same potrafią rozpoznać koniec, na przykład std::counted_iterator. Nie jest uniwersalnym zamiennikiem end().
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <iterator>
namespace std {
struct default_sentinel_t { };
inline constexpr default_sentinel_t default_sentinel{};
}std::default_sentinel_t, zadeklarowany w <iterator>, jest pustym typem reprezentującym koniec zakresu. Nie przechowuje adresu końca ani liczby elementów. Informację potrzebną do rozpoznania końca musi zapewniać współpracujący iterator.
Rozróżniaj typ std::default_sentinel_t i obiekt std::default_sentinel. Ten drugi jest zadeklarowany jako inline constexpr default_sentinel_t default_sentinel{};. Możesz przekazać gotowy obiekt albo utworzyć wartość przez std::default_sentinel_t{}. Deklaracje w polu składni opisują bibliotekę; w swoim programie dołącz nagłówek, zamiast ponownie deklarować te nazwy w namespace std.
Typowym partnerem jest std::counted_iterator: przechowuje iterator bazowy i liczbę pozostałych kroków. Porównanie z tym znacznikiem daje równość, gdy licznik wynosi zero. Znacznik nie jest iteratorem: nie służy do dereferencji ani inkrementacji. Nie działa też automatycznie ze zwykłym wskaźnikiem lub dowolnym iteratorem kontenera — potrzebne jest odpowiednie porównanie iteratora ze znacznikiem.
W przykładzie licznik 3 ogranicza przejście do pierwszych trzech elementów tablicy, dlatego oczekiwany wynik to 24 i znak nowej linii. Licznik nie może zastępować kontroli poprawności zakresu: zapewnij wystarczającą liczbę dostępnych elementów i nie dereferencjonuj iteratora po osiągnięciu końca.
Przykłady
#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';
}
Wynik
24
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.