std::flat_m...mplace_hint(3)

💖 NAME 💖

okay bestie, this page is std::flat_m...mplace_hint, and it lives in the C++ Standard Library (yes, the whole vibe). The actual thing: std::flat_multimap::emplace_hint — std::flat_multimap::emplace_hint.

✨ Synopsis ✨

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

So what does it do? It inserts a new element into the container as close as possible to the position just before hint. The element type’s constructor — that’s value_type, aka std::pair<const Key, T> — gets called with exactly the same arguments you supplied to the function, forwarded with std::forward<Args>(args)....

The info 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. that’s the whole return vibe ✨

🦋 Exceptions 🦋

If an exception is thrown for any reason, this function has no effect — it’s giving strong exception safety guarantee. periodt.

🧚 Complexity 🧚

This section is incomplete 😭 (the page literally says so, no cap).

🍓 Example 🍓

This section is incomplete. Reason: no example. 🙈

👑 See also 👑

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

🏷️ Categories 🏷️

• Todo without reason
• Todo no example

cute sign-off bestie: source is http://cppreference.com, version/date is 2024.06.10, and the page label is std::flat_m...mplace_hint(3). stay slay 💅💖