Adds an element constructed in place.
template<class ValTy>
iterator emplace(ValTy&& val);
Parameters
Parameter |
Description |
ValTy |
The in-place constructor argument type. |
val |
Value to insert. |
Remarks
The member function constructs an element X with valand returns the iterator that designates X.
If an exception is thrown during the insertion, the container is left unaltered and the exception is rethrown.
Example
Code
// std_tr1__unordered_multiset__unordered_multiset_emplace.cpp
// compile with: /EHsc
#include <unordered_set>
#include <iostream>
#include <string>
int main()
{
unordered_multiset< string> c1;
string str1("a");
c1.emplace(move(str1));
cout << "After the emplace insertion, c1 contains: "
<< *c1.begin() << endl;
return (0);
}
Output
After the emplace insertion, c1 contains: a
Requirements
Header: <unordered_set>
Namespace: std