std::insert...ert_iterator(3)

🌸 NAME 🌸

std::insert_iterator::insert_iterator — bestie, it's the std::insert_iterator::insert_iterator member, and yes the name really does repeat itself like that. Main character energy 💅✨

📜 Synopsis 📜

This is from the C++ Standard Libary manual (that spelling is literally in the source, no cap 😭).

Until C++20, the signature is giving:

insert_iterator( Container& c, typename Container::iterator i );

(until C++20)

Since C++20, it's serving constexpr:

constexpr insert_iterator( Container& c,
ranges::iterator_t<Container> i );

(since C++20)

Lowkey the important bit: it initializes the underlying pointer to the container to std::addressof(c) and the underlying iterator to i 🫶✨

🎀 Parameters 🎀

• c — container to initialize the inserter with 💖
• i — iterator to initialize the inserter with 🌸

💅 Defect reports 💅

The following behavior-changing defect reports were applied retroactively to previously published C++ standards. Retroactive glow-ups, we love to see it 😭🌈

• LWG 561 — applied to C++98. Behavior as published: the type of i was independent of Container. Correct behavior: it is the iterator type of Container ✨
• P2325R3 — applied to C++20. Behavior as published: default constructor was provided as along with the iterators must be default_initializable requirement. Correct behavior: C++20 removed the requirement 💀

Okay that's the whole page, bestie 🫶 Source/version: http://cppreference.com; date: 2024.06.10; page: std::insert...ert_iterator(3). Slay and stay constexpr ✨💅