Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła