[#bsl-unordered_multiset-06c-equal_range-00]
= xref:bsl.adoc[bsl]::xref:bsl/unordered_multiset-06c.adoc[unordered_multiset]::equal_range
:relfileprefix: ../../
:mrdocs:

`equal_range` overloads

== Synopses

Declared in `<bslstl_unorderedmultiset.h>`

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this unordered multiset equivalent to the specified `key`, where the first iterator is positioned at the start of the sequence, and the second is positioned one past the end of the sequence. If this unordered multiset contains no `value_type` objects equivalent to the `key`, then the two returned iterators will have the same value.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/pair-0b.adoc[bsl::pair<unordered_multiset<KEY, HASH, EQUAL, ALLOCATOR>::iterator, unordered_multiset<KEY, HASH, EQUAL, ALLOCATOR>::iterator>]
xref:bsl/unordered_multiset-06c/equal_range-0c.adoc[equal_range](xref:bsl/unordered_multiset-06c/key_type.adoc[key_type] const& key);
----

[.small]#xref:bsl/unordered_multiset-06c/equal_range-0c.adoc[_» more..._]#

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this unordered multiset equivalent to the specified `key`, where the first iterator is positioned at the start of the sequence, and the second is positioned one past the end of the sequence. If this unordered multiset contains no `value_type` objects equivalent to the `key`, then the two returned iterators will have the same value.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/pair-0b.adoc[bsl::pair<unordered_multiset<KEY, HASH, EQUAL, ALLOCATOR>::const_iterator, unordered_multiset<KEY, HASH, EQUAL, ALLOCATOR>::const_iterator>]
xref:bsl/unordered_multiset-06c/equal_range-07.adoc[equal_range](xref:bsl/unordered_multiset-06c/key_type.adoc[key_type] const& key) const;
----

[.small]#xref:bsl/unordered_multiset-06c/equal_range-07.adoc[_» more..._]#

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this unordered multiset equivalent to the specified `key`, where the first iterator is positioned at the start of the sequence, and the second is positioned one past the end of the sequence. If this unordered multiset contains no `value_type` objects equivalent to the `key`, then the two returned iterators will have the same value. The behavior is undefined unless `key` is equivalent to the elements of at most one equivalent‐key group in this unordered multiset.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class LOOKUP_KEY>
xref:bsl/pair-0b.adoc[pair<iterator, iterator>]
xref:bsl/unordered_multiset-06c/equal_range-06.adoc[equal_range](LOOKUP_KEY const& key)
requires BloombergLP::bslmf::IsTransparentPredicate<HASH, LOOKUP_KEY>::value
        && BloombergLP::bslmf::IsTransparentPredicate<EQUAL,LOOKUP_KEY>::value;
----

[.small]#xref:bsl/unordered_multiset-06c/equal_range-06.adoc[_» more..._]#

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this unordered multiset equivalent to the specified `key`, where the first iterator is positioned at the start of the sequence, and the second is positioned one past the end of the sequence. If this unordered multiset contains no `value_type` objects equivalent to the `key`, then the two returned iterators will have the same value. The behavior is undefined unless `key` is equivalent to the elements of at most one equivalent‐key group in this unordered multiset.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class LOOKUP_KEY>
xref:bsl/pair-0b.adoc[pair<const_iterator, const_iterator>]
xref:bsl/unordered_multiset-06c/equal_range-0b.adoc[equal_range](LOOKUP_KEY const& key) const
requires BloombergLP::bslmf::IsTransparentPredicate<HASH, LOOKUP_KEY>::value
        && BloombergLP::bslmf::IsTransparentPredicate<EQUAL,LOOKUP_KEY>::value;
----

[.small]#xref:bsl/unordered_multiset-06c/equal_range-0b.adoc[_» more..._]#


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