STD::_LIST_ITERATOR(3)

💖 std::_List_iterator< _Tp > 💖

okay bestie, welcome to the libstdc++ manual page for std::_List_iterator< _Tp > — she's a list::iterator, she's iconic, she lives in <list>, and she is literally just vibing in the standard library waiting for you to walk her through your linked list. no cap. 🦋

---

✨ NAME ✨

std::_List_iterator< _Tp > — a list::iterator. that's it, that's the whole job description. she iterates. periodt. 💅

---

🌸 SYNOPSIS 🌸

#include <list>

---

🎀 Public Types 🎀

bestie she has a whole wardrobe of typedefs, and every single one of them is serving exactly what it's supposed to:

• typedef _List_node< _Tp > _Node — the node type she's cruising around on. her ride. her little home base. 🏠
• typedef ptrdiff_t difference_type — the signed integer type for measuring distance between iterators. yes, ptrdiff_t, the classic. 📏
• typedef std::bidirectional_iterator_tag iterator_category — and THIS is the important one, because she's tagged bidirectional_iterator_tag, meaning she can walk forward AND backward. two directions. main character energy fr fr. 🔥
• typedef _Tp * pointer — pointer to the element type. _Tp *. as promised. ✨
• typedef _Tp & reference — reference to the element type. _Tp &. matching set, obsessed. 💜
• typedef _Tp value_type — the actual element type being stored. the whole point of the operation. 👑

---

🫶 Public Member Functions 🫶

every single one of these is noexcept, which means she is NOT going to throw at you. she's chill like that. 😌

• _List_iterator (__detail::_List_node_base *__x) noexcept — constructor bestie!! hand her a __detail::_List_node_base * named __x and she'll wrap herself around it. that's the whole construction arc. 💖
• _List_iterator _M_const_cast () const noexcept — internal magic (that _M_ prefix is the giveaway, iykyk) that hands you back a _List_iterator from a const context. she's a const member function, and she does not throw. 🧚
• reference operator* () const noexcept — the dereference glow-up!! gives you a reference to the thing she's pointing at. const, and yes, noexcept. ⭐
• _List_iterator & operator++ () const noexcept — wait bestie, read that again, it's a const member function that returns _List_iterator &. pre-increment!! move forward, return yourself. slay. ✨
• _List_iterator operator++ (int) noexcept — post-increment!! that lonely int parameter is the classic dummy argument that exists purely so the compiler can tell the two ++ versions apart. she returns a _List_iterator by value — the old position, preserved like a little polaroid. 📸
• _List_iterator & operator-- () const noexcept — pre-decrement!! going backwards, also a const member function, also returns _List_iterator &. bidirectional, remember? told you. 🌈
• _List_iterator operator-- (int) noexcept — post-decrement, same int dummy-argument trick, returns the pre-decrement copy by value. iconic behaviour, honestly. 🎀
• pointer operator-> () const noexcept — the arrow!! gives you a pointer so you can reach straight through to a member. const, noexcept, perfect. 💅

---

🌟 Public Attributes 🌟

just one, and she's doing a LOT of heavy lifting:

• __detail::_List_node_base * _M_node — the raw pointer to the node base. this is the whole entire state of the iterator. everything above is just choreography around this one pointer. respect her. 🙈

---

💞 Friends 💞

• bool operator== (const _List_iterator &__x, const _List_iterator &__y) noexcept — equality comparison between two iterators, taking __x and __y, returning bool, and (say it with me) noexcept. friendship means she gets to peek at your privates. that's the C++ way. 💖

---

🦋 Detailed Description 🦋

template<typename _Tp>
    struct std::_List_iterator< _Tp >

"A list::iterator.

All the functions are op overloads."

yeah. that's the whole thing. all the functions are op overloads — every single member function up there is an operator overload. *, ++, --, ->, all of it. she doesn't have a personality beyond operators, and honestly? she doesn't need one. she ate and left no crumbs. 👑

---

✍️ Author ✍️

Generated automatically by Doxygen for libstdc++ from the source code. so like, no human wrote this by hand — Doxygen did it, machine-style, no cap. 🤖✨

---

bestie quick recap so you don't forget: #include <list>, bidirectional, noexcept everything, one single _M_node attribute holding the whole vibe together, and a friend operator==. that's her. that's the iterator. 💜

---

okay that's a wrap!! this page came to you from libstdc++ (the library, not a date — the footer's just repping the source, she's timeless like that 💅) and yes, the footer also says std::_List...tor< _Tp >(3) because the title got truncated on the way out, and honestly? relatable. mwah. 😘🎀