Create an unordered multimap, and insert each value_type object in the sequence starting at the specified first element, and ending immediately before the specified last element. Optionally specify an initialNumBuckets indicating the minimum initial size of the array of buckets of this container. If initialNumBuckets is not supplied, a single empty bucket is used if first and last denote an empty range, and an unspecified number of buckets is used otherwise. Optionally specify a hashFunction used to generate hash values for the keys contained in this unordered multimap. If hashFunction is not supplied, a default-constructed object of (template parameter) type HASH is used. Optionally specify a key-equivalence functor keyEqual used to verify that two keys are equivalent. If keyEqual is not supplied, a default-constructed object of (template parameter) type EQUAL is used. Optionally specify a basicAllocator used to supply memory. If basicAllocator is not supplied, a default-constructed object of the (template parameter) type ALLOCATOR is used. If the type ALLOCATOR is bsl::allocator and basicAllocator is not supplied, the currently installed default allocator is used to supply memory. The (template parameter) type INPUT_ITERATOR shall meet the requirements of an input iterator defined in the C++11 standard [24.2.3]providing access to values of a type convertible to value_type, and value_type must be emplace-constructible from *i into this unordered multimap, where i is a dereferenceable iterator in the range [first .. last)] (see {Requirements on KEY and VALUE}). The behavior is undefined unless first and last refer to a sequence of valid values where first is at a position at or before last. Note that a bslma::Allocator * can be supplied for basicAllocator if the type ALLOCATOR is bsl::allocator (the default).
Declared in <bslstl_unorderedmultimap.h>
template<class INPUT_ITERATOR>
unordered_multimap(
INPUT_ITERATOR first,
INPUT_ITERATOR last,
size_type initialNumBuckets = 0,
HASH const& hashFunction = HASH(),
EQUAL const& keyEqual = EQUAL(),
ALLOCATOR const& basicAllocator = ALLOCATOR());