Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::default_sentinel_t — marcador de fim de intervalo

std::default_sentinel_t é um tipo vazio usado como marcador de fim de intervalo, declarado em <iterator>. Funciona com iteradores capazes de determinar por si próprios o fim, como std::counted_iterator. Não é um substituto universal de end().

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <iterator>

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

std::default_sentinel_t, declarado em <iterator>, é um tipo vazio que representa o fim de um intervalo. Não armazena um endereço final nem o número de elementos. O iterador associado tem de fornecer a informação necessária para reconhecer o fim.

Distingue o tipo std::default_sentinel_t do objeto std::default_sentinel. Este último é declarado como inline constexpr default_sentinel_t default_sentinel{};. Podes passar o objeto já disponível ou construir um valor com std::default_sentinel_t{}. As declarações no campo da sintaxe descrevem a biblioteca; no teu programa, inclui o cabeçalho em vez de voltares a declarar estes nomes em namespace std.

Um parceiro habitual é std::counted_iterator: armazena um iterador subjacente e o número de passos restantes. A comparação com este marcador indica igualdade quando o contador é zero. O marcador não é um iterador: não é usado para desreferenciar nem incrementar. Também não funciona automaticamente com um ponteiro normal ou com qualquer iterador de contentor — é necessário suporte adequado para comparar iteradores com marcadores.

No exemplo, a contagem 3 limita o percurso aos três primeiros elementos do array, pelo que o resultado esperado é 24 seguido de uma mudança de linha. A contagem não substitui as verificações de validade do intervalo: certifica-te de que há elementos acessíveis em número suficiente e não desreferencies o iterador depois de chegar ao fim.

Exemplos

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

Resultado

24

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes