[#bsl-unordered_multimap-0b0-equal_range-0c]
= xref:bsl.adoc[bsl]::xref:bsl/unordered_multimap-0b0.adoc[unordered_multimap]::equal_range
:relfileprefix: ../../
:mrdocs:

`equal_range` overloads

== Synopses

Declared in `<bslstl_unorderedmultimap.h>`

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this unordered multimap with a key 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 multimap contains no `value_type` objects with a key equivalent to `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_multimap<KEY, VALUE, HASH, EQUAL, ALLOCATOR>::iterator, unordered_multimap<KEY, VALUE, HASH, EQUAL, ALLOCATOR>::iterator>]
xref:bsl/unordered_multimap-0b0/equal_range-03.adoc[equal_range](xref:bsl/unordered_multimap-0b0/key_type.adoc[key_type] const& key);
----

[.small]#xref:bsl/unordered_multimap-0b0/equal_range-03.adoc[_» more..._]#

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this unordered multimap with a key 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 multimap contains no `value_type` objects with a key equivalent to `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_multimap<KEY, VALUE, HASH, EQUAL, ALLOCATOR>::const_iterator, unordered_multimap<KEY, VALUE, HASH, EQUAL, ALLOCATOR>::const_iterator>]
xref:bsl/unordered_multimap-0b0/equal_range-07.adoc[equal_range](xref:bsl/unordered_multimap-0b0/key_type.adoc[key_type] const& key) const;
----

[.small]#xref:bsl/unordered_multimap-0b0/equal_range-07.adoc[_» more..._]#

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this unordered multimap with a key 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 multimap contains no `value_type` objects with a key equivalent to `key`, then the two returned iterators will have the same value. The behavior is undefined unless `key` is equivalent to the key of the elements of at most one equivalent‐key group in this unordered multimap.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class LOOKUP_KEY>
xref:bsl/pair-0b.adoc[pair<iterator, iterator>]
xref:bsl/unordered_multimap-0b0/equal_range-04.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_multimap-0b0/equal_range-04.adoc[_» more..._]#

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this unordered multimap with a key 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 multimap contains no `value_type` objects with a key equivalent to `key`, then the two returned iterators will have the same value. The behavior is undefined unless `key` is equivalent to the key of the elements of at most one equivalent‐key group in this unordered multimap.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class LOOKUP_KEY>
xref:bsl/pair-0b.adoc[pair<const_iterator, const_iterator>]
xref:bsl/unordered_multimap-0b0/equal_range-05.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_multimap-0b0/equal_range-05.adoc[_» more..._]#


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