hash_multimap::emplace
Note
This API is obsolete. The alternative is unordered_multimap Class.
Inserts an element constructed in place into a hash_multimap.
template<class ValTy>
iterator emplace(
ValTy&& _Val
);
Parameters
Parameter |
Description |
_Val |
The value used to move construct an element to be inserted into the hash_multimap Class. |
Return Value
The emplace member function returns an iterator that points to the position where the new element was inserted.
Remarks
The hash_multimap::value_type of an element is a pair, so that the value of an element will be an ordered pair with the first component equal to the key value and the second component equal to the data value of the element.
Beginning with Visual C++ .NET 2003, members of the <hash_map> and <hash_set> header files are no longer in the std namespace, but rather have been moved into the stdext namespace. See The stdext Namespace for more information.
Example
// hash_multimap_emplace.cpp
// compile with: /EHsc
#include<hash_multimap>
#include<iostream>
#include <string>
int main()
{
using namespace std;
using namespace stdext;
hash_multimap<int, string> hm1;
typedef pair<int, string> is1(1, "a");
hm1.emplace(move(is1));
cout << "After the emplace, hm1 contains:" << endl
<< " " << hm1.begin()->first
<< " => " << hm1.begin()->second
<< endl;
}
After the emplace insertion, hm1 contains: 1 => a
Requirements
Header: <hash_map>
Namespace: stdext