Namespaces
Variants

std:: iterator_traits <std::common_iterator>

From cppreference.net
C++
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
std::common_iterator
Определено в заголовочном файле <iterator>
template < std:: input_iterator I, class S >
struct iterator_traits < std:: common_iterator < I, S >> ;
(начиная с C++20)

Предоставляет унифицированный интерфейс к свойствам типа std::common_iterator .

Содержание

Типы членов

Название типа Определение
iterator_concept
iterator_category
(условно присутствует)
value_type std:: iter_value_t < I >
difference_type std:: iter_difference_t < I >
pointer
  • decltype ( c. operator - > ( ) ) , если это корректно сформировано (где c является lvalue типа const std:: common_iterator < I, S > ).
  • void в противном случае.
reference std:: iter_reference_t < I >

Пример

Запустить этот код 
#include <iterator>
#include <type_traits>
#include <vector>
int main()
{
    std::vector v{1, 2, 3, 4};
    using CV = std::common_iterator<
                    std::counted_iterator<std::vector<int>::iterator>,
                    std::default_sentinel_t>;
    CV i{std::counted_iterator{v.begin(), 3}};
    using TRCV = std::iterator_traits<decltype(i)>;
    static_assert(std::is_same<TRCV::iterator_concept, std::forward_iterator_tag>());
    static_assert(std::is_same<TRCV::iterator_category, std::forward_iterator_tag>());
    static_assert(std::is_same<TRCV::value_type, int>());
    static_assert(std::is_same<TRCV::difference_type,
                  std::vector<int>::difference_type>());
    static_assert(std::is_same<TRCV::pointer, decltype(i.operator->())>());
    static_assert(std::is_same<TRCV::reference, int&>());
    CV s{std::default_sentinel};
    using TRCS = std::iterator_traits<decltype(s)>;
    static_assert(std::is_same<TRCS::iterator_concept, std::forward_iterator_tag>());
    static_assert(std::is_same<TRCS::iterator_category, std::forward_iterator_tag>());
    static_assert(std::is_same<TRCS::value_type, int>());
    static_assert(std::is_same<TRCS::difference_type,
                  std::vector<int>::difference_type>());
    static_assert(std::is_same<TRCS::pointer, decltype(s.operator->())>());
    static_assert(std::is_same<TRCS::reference, int&>());
}

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Применяется к Поведение в опубликованной версии Корректное поведение
LWG 3749 C++20 если std:: iter_difference_t < I > не является целочисленным типом,
iterator_category был std::input_iterator_tag 		iterator_category является
неопределённым в этом случае

Смотрите также

предоставляет унифицированный интерфейс к свойствам итератора
(шаблон класса)
(C++20)
вычисляет ассоциированный тип разности для типа std::common_iterator
(специализация шаблона класса)