[#bsl-multimap-0ae-equal_range-00]
= xref:bsl.adoc[bsl]::xref:bsl/multimap-0ae.adoc[multimap]::equal_range
:relfileprefix: ../../
:mrdocs:

`equal_range` overloads

== Synopses

Declared in `<bslstl_multimap.h>`

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this multimap whose keys are 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. The first returned iterator will be `lower_bound(key)`, the second returned iterator will be `upper_bound(key)`, and, if this multimap contains no `value_type` object with an equivalent 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<iterator, iterator>]
xref:bsl/multimap-0ae/equal_range-0a.adoc[equal_range](xref:bsl/multimap-0ae/key_type.adoc[key_type] const& key);
----

[.small]#xref:bsl/multimap-0ae/equal_range-0a.adoc[_» more..._]#

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this multimap whose keys are equivalent to the specified `key`, where the first iterator is positioned at the start of the sequence and the second iterator is positioned one past the end of the sequence. The first returned iterator will be `lower_bound(key)`, the second returned iterator will be `upper_bound(key)`, and, if this multimap contains no `value_type` objects having keys 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[pair<const_iterator, const_iterator>]
xref:bsl/multimap-0ae/equal_range-07.adoc[equal_range](xref:bsl/multimap-0ae/key_type.adoc[key_type] const& key) const;
----

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

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this multimap whose keys are 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. The first returned iterator will be `lower_bound(key)`, the second returned iterator will be `upper_bound(key)`, and, if this multimap contains no `value_type` object with an equivalent key, then the two returned iterators will have the same value.


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

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

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this multimap whose keys are equivalent to the specified `key`, where the first iterator is positioned at the start of the sequence and the second iterator is positioned one past the end of the sequence. The first returned iterator will be `lower_bound(key)`, the second returned iterator will be `upper_bound(key)`, and, if this multimap contains no `value_type` objects having keys equivalent to `key`, then the two returned iterators will have the same value.


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

[.small]#xref:bsl/multimap-0ae/equal_range-04.adoc[_» more..._]#


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