std::flat_m...mplace_hint(3)

💖 NAME 💖

okay bestie, we're in the C++ Standard Libary manual — yes, that's the exact spelling in the header, typo and all, iconic — and this page is std::flat_m...mplace_hint(3) 💅.

The actual name is std::flat_multiset::emplace_hint, and the page's name line literally says std::flat_multiset::emplace_hint — std::flat_multiset::emplace_hint (yes, it repeats itself, no notes).

✨ Synopsis ✨

template< class... Args >
iterator emplace_hint( const_iterator hint, Args&&... args );

(since C++23) ✨

What it does: inserts a new element into the container as close as possible to the position just before hint 🫶.

The constructors of the key and mapped value are called with exactly the same arguments as supplied to the function, forwarded with std::forward<Args>(args)... — exactly, no extras, no remix 🔥.

Also, a tiny note that literally says: Information on iterator invalidation is copied from here. iykyk.

🌸 Parameters 🌸

• hint — iterator to the position before which the new element will be inserted 🎯
• args — arguments to forward to the constructor of the element 🧚

🎀 Return value 🎀

An iterator to the inserted element. slay. ✨

🦋 Exceptions 🦋

If an exception is thrown for any reason, this function has no effect — that's the strong exception safety guarantee, periodt 💀. Like, any reason at all, bestie.

⭐ Complexity ⭐

This section is incomplete 😭. That's genuinely all it says here.

💅 Example 💅

This section is incomplete 🫠

Reason: no example — literally the reason the page gives. no example era, I guess.

🌈 See also 🌈

• emplace — constructs element in-place (public member function) 👑
• insert — inserts elements (public member function) 🌟

🍓 Categories 🍓

• Todo without reason
• Todo no example

---

and that's the whole page, bestie 💖! footer vibes: source/version is http://cppreference.com, date is 2024.06.10, and the page name down there is std::flat_m...mplace_hint(3) — mwah 💋.