std::flat_multiset<Key,Compare,KeyContainer>::emplace - cppreference.com (original) (raw)

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

Inserts a new element into the container constructed in-place with the given args.

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

This overload participates in overload resolution only if std::is_constructible_v<value_type, Args...> is true.

If value_type is not EmplaceConstructible into flat_multiset from args, the behavior is undefined.

Contents

• 1 Parameters
• 2 Return value
• 3 Exceptions
• 4 Complexity
• 5 Notes
• 6 Example
• 7 See also

[edit] Parameters

[edit] Return value

An iterator to the inserted element.

[edit] Exceptions

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

[edit] Complexity

Logarithmic in the size of the container.

[edit] Notes

Careful use of emplace allows the new element to be constructed while avoiding unnecessary copy or move operations.

[edit] Example

[edit] See also