CKTIS / C++
std::default_sentinel_t — маркер за край на диапазон
std::default_sentinel_t е празен тип за маркер за край на диапазон от <iterator>. Работи с итератори, които могат сами да определят края, например std::counted_iterator. Не е универсален заместител на end().
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <iterator>
namespace std {
struct default_sentinel_t { };
inline constexpr default_sentinel_t default_sentinel{};
}std::default_sentinel_t, деклариран в <iterator>, е празен тип, който представя края на диапазон. Той не съхранява адрес на края или брой елементи. Свързаният итератор трябва да предоставя информацията, необходима за разпознаване на края.
Разграничавайте типа std::default_sentinel_t от обекта std::default_sentinel. Последният е деклариран като inline constexpr default_sentinel_t default_sentinel{};. Можете да подадете готовия обект или да създадете стойност с std::default_sentinel_t{}. Декларациите в полето за синтаксис описват библиотеката; във вашата програма включете заглавния файл, вместо да декларирате тези имена повторно в namespace std.
Типичен партньор е std::counted_iterator: той съхранява базов итератор и броя на оставащите стъпки. Сравнението с този маркер е равно, когато броячът е нула. Маркерът не е итератор: не се използва за дереференция или увеличаване. Той не работи автоматично и с обикновен указател или произволен итератор на контейнер — необходима е подходяща поддръжка за сравнение между итератор и маркер.
В примера броячът 3 ограничава обхождането до първите три елемента на масива, затова очакваният изход е 24, последван от нов ред. Броячът не замества проверките за валидност на диапазона: уверете се, че има достатъчно достъпни елементи, и не дереферирайте итератора след достигане на края.
Примери
#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';
}
Резултат
24
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.