# std::incrementable_traits<std::common_iterator>

> C++ Atlas: `cppatlas.com/w/cpp/iterator/common_iterator/incrementable_traits` | Source: https://en.cppreference.com/w/cpp/iterator/common_iterator/incrementable_traits | Domain: Iterator | Standards: C++20, C++23

Provides the uniform interface to the associated difference type of the std::common_iterator type.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <iterator>

template< class I, class S >
struct incrementable_traits<std::common_iterator<I, S>> {
    using difference_type = std::iter_difference_t<I>;
}; // (since C++20)
```

Provides the uniform interface to the associated difference type of the `std::common_iterator` type.

### Example

```cpp
#include <cstddef>
#include <iterator>
#include <list>
#include <string>
#include <type_traits>

int main()
{
    using CI = std::common_iterator<
                   std::counted_iterator<int*>,
                   std::default_sentinel_t>;
    using CL = std::common_iterator<
                   std::counted_iterator<std::list<std::string>::iterator>,
                   std::default_sentinel_t>;
    CL cl{std::default_sentinel};
    static_assert(
        std::same_as<std::incrementable_traits<CI>::difference_type, std::ptrdiff_t> &&
        std::same_as<std::incrementable_traits<CL>::difference_type, std::ptrdiff_t> &&
        std::same_as<std::incrementable_traits<decltype(cl)>::difference_type,
                     std::ptrdiff_t>);
}
```

### See also

- [`incrementable_traits`](https://en.cppreference.com/w/cpp/iterator/incrementable_traits) (C++20): computes the difference type of a `weakly_incrementable` type (class template)
- [`iter_value_t`](https://en.cppreference.com/w/cpp/iterator/iter_t) (C++20), [`iter_reference_t`](https://en.cppreference.com/w/cpp/iterator/iter_t) (C++20), [`iter_const_reference_t`](https://en.cppreference.com/w/cpp/iterator/iter_t) (C++23), [`iter_difference_t`](https://en.cppreference.com/w/cpp/iterator/iter_t) (C++20), [`iter_rvalue_reference_t`](https://en.cppreference.com/w/cpp/iterator/iter_t) (C++20), [`iter_common_reference_t`](https://en.cppreference.com/w/cpp/iterator/iter_t) (C++20): computes the associated types of an iterator (alias template)
- [`std::iterator_traits<std::common_iterator>`](https://en.cppreference.com/w/cpp/iterator/common_iterator/iterator_traits) (C++20): provides uniform interface to the properties of the `std::common_iterator` type (class template specialization)

---
Attribution: content from https://en.cppreference.com/w/cpp/iterator/common_iterator/incrementable_traits (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.