STD::BACK_INSERT_ITERATOR(3)

✨ NAME ✨

std::back_insert_iterator< _Container > — turns assignment into insertion 💅 no cap

This one lives in the Library Functions Manual, bestie, so you know it's the real deal.

---

🦋 SYNOPSIS 🦋

#include <iterator>

It inherits std::iterator< output_iterator_tag, void, void, void, void >. Periodt.

🎀 Public Types 🎀

• typedef _Container container_type — a nested typedef for the type of whatever container you used. whatever you brought to the function, basically 🫶
• using difference_type — that's it. that's the whole thing. no blurb provided, she's just there being iconic 💅
• typedef output_iterator_tag iterator_category — one of the tag types.
• typedef void pointer — this type represents a pointer-to-value_type.
• typedef void reference — this type represents a reference-to-value_type.
• typedef void value_type — the type "pointed to" by the iterator.

🌈 Public Member Functions 🌈

• constexpr back_insert_iterator (_Container &__x) — the only way to create this iterator is with a container. that's the whole vibe. no container, no iterator, sorry 🥲
• constexpr back_insert_iterator & operator* () — simply returns *this. literally just hands you back herself. queen behaviour 👑
• constexpr back_insert_iterator & operator++ () — simply returns *this. (This iterator does not move.) — yes bestie she does NOT move, that's not a bug that's the whole point 💀
• constexpr back_insert_iterator operator++ (int) — simply returns *this. (This iterator does not move.) — same energy, postfix flavour ✨
• constexpr back_insert_iterator & operator= (const typename _Container::value_type &__value)
• constexpr back_insert_iterator & operator= (typename _Container::value_type &&__value)

🔒 Protected Attributes 🔒

• _Container * container

---

💖 Detailed Description 💖

template<typename _Container>
class std::back_insert_iterator< _Container >

Turns assignment into insertion. 🪄

These are output iterators, constructed from a container-of-T. Assigning a T to the iterator appends it to the container using push_back. so like, you're not picking a spot, you're just yeeting stuff onto the end, and honestly? valid.

Tip: Using the back_inserter function to create these iterators can save typing. fr fr, save your fingers 🫶

---

🌸 Member Typedef Documentation 🌸

• template<typename _Container> typedef _Container std::back_insert_iterator< _Container >::container_type — a nested typedef for the type of whatever container you used.
• typedef output_iterator_tag std::iterator< output_iterator_tag, void, void, void, void >::iterator_category [inherited] — one of the tag types.
• typedef void std::iterator< output_iterator_tag, void, void, void, void >::pointer [inherited] — this type represents a pointer-to-value_type.
• typedef void std::iterator< output_iterator_tag, void, void, void, void >::reference [inherited] — this type represents a reference-to-value_type.
• typedef void std::iterator< output_iterator_tag, void, void, void, void >::value_type [inherited] — the type "pointed to" by the iterator.

---

🧚 Constructor & Destructor Documentation 🧚

• template<typename _Container> std::back_insert_iterator< _Container >::back_insert_iterator (_Container & __x) [inline], [explicit], [constexpr] — the only way to create this iterator is with a container. (yes, she said what she said the first time too.)

References std::__addressof().

---

👑 Member Function Documentation 👑

• template<typename _Container> back_insert_iterator & std::back_insert_iterator< _Container >::operator* () [inline], [nodiscard], [constexpr] — simply returns *this.
• template<typename _Container> back_insert_iterator & std::back_insert_iterator< _Container >::operator++ () [inline], [constexpr] — simply returns *this. (This iterator does not move.).
• template<typename _Container> back_insert_iterator std::back_insert_iterator< _Container >::operator++ (int ) [inline], [constexpr] — simply returns *this. (This iterator does not move.).
• template<typename _Container> back_insert_iterator & std::back_insert_iterator< _Container >::operator= (const typename _Container::value_type & __value) [inline], [constexpr]

Parameters

• __value — an instance of whatever type container_type::const_reference is; presumably a reference-to-const T for container<T>.

Returns

• This iterator, for chained operations. slay, chain away 💅

This kind of iterator doesn't really have a position in the container (you can think of the position as being permanently at the end, if you like). Assigning a value to the iterator will always append the value to the end of the container. always. every time. no exceptions bestie, that's just who she is 🌈

---

💜 Author 💜

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

---

okay that's the whole page bestie!! 🎀 go forth and push_back responsibly ✨ — this cutie was brought to you by libstdc++, page 3 of the Library Functions Manual, and she ate, no crumbs left 🌸🦋💖