template< class... Args >
iterator emplace( const_iterator pos, Args&&... args );
Inserts a new element into the container directly before
pos. The element is constructed in-place, i.e. no copy or move operations are performed. The constructor of the element is called with the arguments std::forward<Args>(args).... The element type must be
If the new
size() is greater than
capacity(), all iterators and references are invalidated. Otherwise, only the iterators and references after the added element are invalidated. Past-the-end iterator is also invalidated.
|pos||-||iterator before which the new element will be constructed|
|args||-||arguments to forward to the constructor of the element|
 Return value
Iterator pointing to the emplaced element.
Linear in the distance between
pos and end of the container.
If an exception is thrown (e.g. by the constructor), the container is left unmodified, as if this function was never called (strong exception guarantee).
 See also
| inserts elements |
(public member function)