std::insert...:operator++(3)

💅 std::insert_iterator::operator++ 💅

okay so bestie, welcome to the std::insert...:operator++(3) page from the C++ Standard Libary manual — yes, that's the exact manual name, typo and all, don't come for me 😭. This is the tiny little operator page that's basically the backstage pass for insert iterators. It looks boring, but it's lowkey doing important contract work. ✨

👑 NAME 👑

std::insert_iterator::operator++ - std::insert_iterator::operator++. That's it. That's the name. It's giving "I have one job and the job is my name" energy 💀.

✨ Synopsis ✨

here's the whole cast, and yes we're keeping the C++20 glow-up tags exactly:

insert_iterator& operator++();                 (until C++20)
constexpr insert_iterator& operator++();       (since C++20)
insert_iterator& operator++( int );            (until C++20)
constexpr insert_iterator& operator++( int );  (since C++20)

So there are two shapes: one with no argument and one that takes an int. The first pair is insert_iterator& operator++(); until C++20, then constexpr insert_iterator& operator++(); since C++20. The second pair is insert_iterator& operator++( int ); until C++20, then constexpr insert_iterator& operator++( int ); since C++20. 🎀

Does nothing. Yup, fr fr — these operator overloads are provided to satisfy the requirements of LegacyOutputIterator. They make it possible for the expressions *iter++=value and *++iter=value to be used to output (insert) a value into the underlying container. That's the whole plot. No secret side quest. 🦋

lowkey iconic: an operator that does nothing but still has to exist so the iterator plays nice with LegacyOutputIterator. no cap, that's the vibe. 💅

🎀 Parameters 🎀

• (none) — literally no parameters, bestie. zero. nada. the void has entered the chat 🫶.

💖 Return value 💖

• *this — it returns *this, which is main character energy in its purest form: it just hands you back itself 👑.

that's the whole page, bestie — short, sweet, and contract-compliant. signed with love by source/version http://cppreference.com, dated 2024.06.10 🌈💖