std::multim...emplace_hint(3)

okay so this is the std::multim...emplace_hint(3) page (aka std::multimap::emplace_hint) from the C++ Standard Libary man pages — yes, that's the header's spelling, not a typo I made 😭💖

💖 NAME 💖

std::multimap::emplace_hint — std::multimap::emplace_hint

🌸 Synopsis 🌸

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

bestie, what this does is insert a new element into the container as close as possible to the position just before hint. that's the whole vibe. ✨

The constructor of the element type (value_type, that is, std::pair<const Key, T>) is called with exactly the same arguments as supplied to the function, forwarded with std::forward<Args>(args)....

No iterators or references are invalidated. periodt. 💅

🎀 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, fr fr. 🫶

⭐ Complexity ⭐

Logarithmic in the size of the container in general, but amortized constant if the new element is inserted just before hint.

🍓 Example 🍓

This section is incomplete Reason: no example

✨ See also ✨

• emplace — constructs element in-place (C++11) (public member function)
• insert — inserts elements or nodes (since C++17) (public member function)

👑 Category 👑

* Todo no example

mwah 💋 source: http://cppreference.com; dated 2024.06.10. byeee bestie 🫶