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.