Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::default_sentinel_t — marcatore di fine intervallo

std::default_sentinel_t è un tipo vuoto usato come marcatore di fine intervallo, dichiarato in <iterator>. Funziona con iteratori capaci di determinare autonomamente la fine, come std::counted_iterator. Non è un sostituto universale di end().

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <iterator>

namespace std {
    struct default_sentinel_t { };
    inline constexpr default_sentinel_t default_sentinel{};
}

std::default_sentinel_t, dichiarato in <iterator>, è un tipo vuoto che rappresenta la fine di un intervallo. Non memorizza né un indirizzo finale né il numero di elementi. L’iteratore associato deve fornire le informazioni necessarie per riconoscere la fine.

Distingui il tipo std::default_sentinel_t dall’oggetto std::default_sentinel. Quest’ultimo è dichiarato come inline constexpr default_sentinel_t default_sentinel{};. Puoi passare l’oggetto già disponibile oppure costruire un valore con std::default_sentinel_t{}. Le dichiarazioni nel campo della sintassi descrivono la libreria; nel tuo programma, includi l’header invece di ridichiarare questi nomi in namespace std.

Un partner tipico è std::counted_iterator: memorizza un iteratore sottostante e il numero di passi rimanenti. Il confronto con questo marcatore risulta uguale quando il contatore è zero. Il marcatore non è un iteratore: non serve per dereferenziare né per incrementare. Inoltre, non funziona automaticamente con un normale puntatore o con un iteratore qualsiasi di un contenitore: è necessario il supporto per un confronto appropriato tra iteratore e marcatore.

Nell’esempio, il conteggio 3 limita l’attraversamento ai primi tre elementi dell’array, quindi l’output atteso è 24 seguito da un carattere di nuova riga. Il conteggio non sostituisce i controlli di validità dell’intervallo: assicurati che siano accessibili abbastanza elementi e non dereferenziare l’iteratore dopo aver raggiunto la fine.

Esempi

#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';
}

Risultato

24

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti