[#bsl-hash_multiset]
= xref:bsl.adoc[bsl]::hash_multiset
:relfileprefix: ../
:mrdocs:

Legacy STLPort hash container storing possibly duplicate values.

== Synopsis

Declared in `<bslstp_hashset.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class _Value,
    class _HashFcn = BloombergLP::bslstp::HashSelector<_Value>::Type,
    class _EqualKey = bsl::ComparatorSelector<_Value>::Type,
    class _Alloc = xref:bsl/allocator-0df.adoc[bsl::allocator<_Value>]>
class hash_multiset;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:bsl/hash_multiset/allocator_type.adoc[`allocator_type`] 
| Allocator type used by this multiset.
| xref:bsl/hash_multiset/const_iterator.adoc[`const_iterator`] 
| Iterator providing non‐modifiable access to elements.
| xref:bsl/hash_multiset/const_pointer.adoc[`const_pointer`] 
| Pointer to a non‐modifiable element.
| xref:bsl/hash_multiset/const_reference.adoc[`const_reference`] 
| Reference to a non‐modifiable element.
| xref:bsl/hash_multiset/difference_type.adoc[`difference_type`] 
| Signed integral type used for iterator distances.
| xref:bsl/hash_multiset/hasher.adoc[`hasher`] 
| Hash functor type.
| xref:bsl/hash_multiset/iterator.adoc[`iterator`] 
| Iterator type; identical to `const_iterator`.
| xref:bsl/hash_multiset/key_equal.adoc[`key_equal`] 
| Key‐equality functor type.
| xref:bsl/hash_multiset/key_type.adoc[`key_type`] 
| Key type used by this container.
| xref:bsl/hash_multiset/pointer.adoc[`pointer`] 
| Pointer to a modifiable element.
| xref:bsl/hash_multiset/reference.adoc[`reference`] 
| Reference to a modifiable element.
| xref:bsl/hash_multiset/size_type.adoc[`size_type`] 
| Unsigned integral type used for sizes.
| xref:bsl/hash_multiset/value_type.adoc[`value_type`] 
| Element type stored in the multiset.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:bsl/hash_multiset/2constructor-07b.adoc[`hash_multiset`]         [.small]#[constructor]#
| Constructors
| xref:bsl/hash_multiset/begin.adoc[`begin`] 
| Return an iterator to the first element.
| xref:bsl/hash_multiset/bucket_count.adoc[`bucket_count`] 
| Return the number of buckets in this multiset.
| xref:bsl/hash_multiset/clear.adoc[`clear`] 
| Remove all elements from this multiset.
| xref:bsl/hash_multiset/count.adoc[`count`] 
| Return the number of elements equal to the specified `__key`. Return the number of elements matching the specified key.
| xref:bsl/hash_multiset/elems_in_bucket.adoc[`elems_in_bucket`] 
| Return the number of elements in the specified bucket.
| xref:bsl/hash_multiset/empty.adoc[`empty`] 
| Return `true` if this multiset contains no elements.
| xref:bsl/hash_multiset/end.adoc[`end`] 
| Return the past‐the‐end iterator for this multiset.
| xref:bsl/hash_multiset/equal_range.adoc[`equal_range`] 
| Return iterators delimiting all elements equal to the specified `__key`.
| xref:bsl/hash_multiset/erase-07fb.adoc[`erase`] 
| `erase` overloads
| xref:bsl/hash_multiset/find.adoc[`find`] 
| Return an iterator to an element with the specified `__key`, or `end`.
| xref:bsl/hash_multiset/get_allocator.adoc[`get_allocator`] 
| Return the allocator used by this multiset.
| xref:bsl/hash_multiset/hash_funct.adoc[`hash_funct`] 
| Return the hash functor used by this multiset.
| xref:bsl/hash_multiset/insert-0e.adoc[`insert`] 
| `insert` overloads
| xref:bsl/hash_multiset/insert_noresize.adoc[`insert_noresize`] 
| Insert the specified `__obj` without resizing the bucket vector.
| xref:bsl/hash_multiset/key_eq.adoc[`key_eq`] 
| Return the key‐equality functor used by this multiset.
| xref:bsl/hash_multiset/max_bucket_count.adoc[`max_bucket_count`] 
| Return the maximum number of buckets this multiset can use.
| xref:bsl/hash_multiset/max_size.adoc[`max_size`] 
| Return an upper bound on the number of elements this multiset can hold.
| xref:bsl/hash_multiset/resize.adoc[`resize`] 
| Rebuild the bucket vector using a size suggested by the specified hint.
| xref:bsl/hash_multiset/size.adoc[`size`] 
| Return the number of elements in this multiset.
| xref:bsl/hash_multiset/swap.adoc[`swap`] 
| Exchange the contents of this multiset with those of the specified set.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:bsl/hash_multiset/_M_equal.adoc[`_M_equal`] 
| Return `true` if the specified multisets contain the same elements.
|===


== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:bsl/operator_not_eq-001.adoc[`operator!=`]
| Return `true` if the specified hash multisets do not contain the same elements.
| xref:bsl/operator_eq-098.adoc[`operator==`]
| Return `true` if the specified hash multisets contain the same elements.
| xref:bsl/swap-079.adoc[`swap`]
| Exchange the contents of the specified hash multisets.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#