STD::COUNTED_ITERATOR(3)

✨ NAME ✨

std::counted_iterator< _It > — An iterator adaptor that keeps track of the distance to the end.

---

🌸 SYNOPSIS 🌸

okay so first things first, bestie, you gotta include the header:

#include <iterator>

🎀 Public Types 🎀

• using difference_type
• using iterator_type

💅 Public Member Functions 💅

these are the member functions, and I'm keeping every signature exactly as written because code is not a vibe to mess with:

constexpr counted_iterator (_It __i, iter_difference_t< _It > __n)
template<typename _It2> constexpr counted_iterator (const
    counted_iterator< _It2 > &__x)
constexpr _It base () &&noexcept(is_nothrow_move_constructible_v< _It >)
constexpr const _It & base () const &noexcept
constexpr iter_difference_t< _It > count () const noexcept
constexpr decltype(auto) operator* () const
    noexcept(noexcept(*_M_current))
constexpr decltype(auto) operator* () noexcept(noexcept(*_M_current))
constexpr counted_iterator operator+ (iter_difference_t< _It > __n)
    const
constexpr counted_iterator & operator++ ()
constexpr counted_iterator operator++ (int)
constexpr decltype(auto) operator++ (int)
constexpr counted_iterator & operator+= (iter_difference_t< _It > __n)
constexpr counted_iterator operator- (iter_difference_t< _It > __n)
    const
constexpr counted_iterator & operator-- ()
constexpr counted_iterator operator-- (int)
constexpr counted_iterator & operator-= (iter_difference_t< _It > __n)
constexpr auto operator-> () const noexcept
template<typename _It2> constexpr counted_iterator & operator= (const
    counted_iterator< _It2 > &__x)
constexpr decltype(auto) operator[] (iter_difference_t< _It > __n) const
    noexcept(noexcept(_M_current[__n]))

🫶 Friends 🫶

and these are the friend functions, no cap:

constexpr iter_rvalue_reference_t< _It > iter_move (const
    counted_iterator &__i)
    noexcept(noexcept(ranges::iter_move(__i._M_current)))
template<indirectly_swappable< _It > _It2> constexpr void iter_swap
    (const counted_iterator &__x, const counted_iterator< _It2 > &__y)
    noexcept(noexcept(ranges::iter_swap(__x._M_current,
    __y._M_current)))
constexpr counted_iterator operator+ (iter_difference_t< _It > __n,
    const counted_iterator &__x)
template<common_with< _It > _It2> constexpr iter_difference_t< _It2 >
    operator- (const counted_iterator &__x, const counted_iterator< _It2
    > &__y) noexcept
constexpr iter_difference_t< _It > operator- (const counted_iterator
    &__x, default_sentinel_t) noexcept
constexpr iter_difference_t< _It > operator- (default_sentinel_t, const
    counted_iterator &__y) noexcept
template<common_with< _It > _It2> constexpr strong_ordering operator<=>
    (const counted_iterator &__x, const counted_iterator< _It2 > &__y)
    noexcept
template<common_with< _It > _It2> constexpr bool operator== (const
    counted_iterator &__x, const counted_iterator< _It2 > &__y) noexcept
constexpr bool operator== (const counted_iterator &__x,
    default_sentinel_t) noexcept

---

🔥 Detailed Description 🔥

template line and the class description, exactly as the manpage gives it:

   template<input_or_output_iterator _It>
       class std::counted_iterator< _It >"An iterator adaptor that keeps track
       of the distance to the end.

yes bestie, that quote mark is really in there. I didn't touch it. 🙈

---

👑 Author 👑

Generated automatically by Doxygen for libstdc++ from the source code.

---

okay so that's the whole page, bestie. this was the std::counted_iterator< _It > page from the Library Functions Manual, and the footer says libstdc++ (Doxygen auto-generated, and there was no date on it, so this is your cute sign-off instead 💅✨). periodt. 🦋💖