std::multis...emplace_hint(3)

💖 NAME 💖

okay so bestie, this is the manual page for std::multiset::emplace_hint — and yes, the name repeats: std::multiset::emplace_hint - std::multiset::emplace_hint. It lives in the C++ Standard Libary (that spelling is straight from the header, no cap 💅).

📝 Synopsis 📝

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

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)....

No iterators or references are invalidated. Not a one. ✨

🎯 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 (strong exception safety guarantee). So like, it's giving strong safety, bestie. 🛡️

⏱️ 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. 😭 (tragic, I know)

👀 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 💋 — this page is from http://cppreference.com, dated 2024.06.10, and filed under std::multis...emplace_hint(3). 🎀