Share via


unordered_multiset::emplace

Inserts an element constructed in place (no copy or move operations are performed).

template<class... Args>
    iterator emplace(
        Args&&... args
);

Parameters

Parameter

Description

args

The arguments forwarded to construct an element to be inserted into the unordered_multiset.

Return Value

An iterator to the newly inserted element.

Remarks

No references to container elements are invalidated by this function, but it may invalidate all iterators to the container.

During the insertion, if an exception is thrown but does not occur in the container's hash function, the container is not modified. If the exception is thrown in the hash function, the result is undefined.

For a code example, see multiset::emplace.

Requirements

Header: <unordered_set>

Namespace: std

See Also

Reference

<unordered_set>

unordered_multiset Class

Standard Template Library