[#bsl-multiset-03-equal_range-00]
= xref:bsl.adoc[bsl]::xref:bsl/multiset-03.adoc[multiset]::equal_range
:relfileprefix: ../../
:mrdocs:

`equal_range` overloads

== Synopses

Declared in `<bslstl_multiset.h>`

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

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

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this multiset that 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 multiset contains no `value_type` objects 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/multiset-03/equal_range-0f9.adoc[equal_range](xref:bsl/multiset-03/key_type.adoc[key_type] const& key) const;
----

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

Return a pair of iterators providing modifiable access to the sequence of `value_type` objects in this 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. The first returned iterator will be `lower_bound(key)`, the second returned iterator will be `upper_bound(key)`, and, if this multiset contains no `value_type` objects 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/multiset-03/equal_range-07.adoc[equal_range](LOOKUP_KEY const& key)
requires BloombergLP::bslmf::IsTransparentPredicate<COMPARATOR,
                                                   LOOKUP_KEY>::value;
----

[.small]#xref:bsl/multiset-03/equal_range-07.adoc[_» more..._]#

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this multiset that 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 multiset contains no `value_type` objects 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/multiset-03/equal_range-0e.adoc[equal_range](LOOKUP_KEY const& key) const
requires BloombergLP::bslmf::IsTransparentPredicate<COMPARATOR,
                                                   LOOKUP_KEY>::value;
----

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


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