std::flat_m...set::emplace(3)

💅 NAME 💅

std::flat_multiset::emplace — std::flat_multiset::emplace, bestie. Straight from the C++ Standard Libary manual, and yes, we are keeping the name exactly as it appears. No cap. ✨

---

🌸 Synopsis 🌸

Okay so here’s the signature, copied exactly because we do not mess with code, periodt:

template< class... Args >            (since C++23)
iterator emplace( Args&&... args );

It inserts a new element into the container, and that element is constructed in-place with the given args. Slay. 💅

First, it initializes an object t of type value_type with std::forward<Args>(args)..., then inserts t as if by:

auto it = ranges::upper_bound(c, t, compare);
c.insert(it, std::move(t));

Overload-resolution vibe check: this overload participates in overload resolution only if std::is_constructible_v<value_type, Args...> is true. Fr fr.

Careful use of emplace allows the new element to be constructed while avoiding unnecessary copy or move operations. That’s the whole point, bestie — careful use is the key word. 💖

🧚 Information on iterator invalidation is copied from here.

---

🎀 Parameters 🎀

• args — arguments to forward to the constructor of the element.

---

💖 Return value 💖

An iterator to the inserted element. That’s it, that’s the return value. 🫶

---

🫶 Exceptions 🫶

If an exception is thrown for any reason, this function has no effect — that’s the strong exception safety guarantee. Iconic behavior, honestly. 😭

---

🔥 Complexity 🔥

Logarithmic in the size of the container. Not linear, bestie. Log. 💅

---

🌈 Example 🌈

This section is incomplete.

Reason: no example.

Not me staring at an empty example section 😭💀.

---

👑 See also 👑

• emplace_hint — constructs elements in-place using a hint (public member function).
• insert — inserts elements (public member function).

---

🍓 Category 🍓

• Todo no example

---

Sign-off tea: source/version http://cppreference.com, date 2024.06.10, page std::flat_m...set::emplace(3). Bye bestie, go emplace something cute! 💖✨