[#bsl-set-0d-equal_range-085]
= xref:bsl.adoc[bsl]::xref:bsl/set-0d.adoc[set]::equal_range
:relfileprefix: ../../
:mrdocs:

Return the const half‐open range of elements equivalent to `key`.

== Synopsis

Declared in `<bslstl_set.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/pair-0b.adoc[pair<const_iterator, const_iterator>]
equal_range(xref:bsl/set-0d/key_type.adoc[key_type] const& key) const;
----

== Description

Return a pair of iterators providing non‐modifiable access to the sequence of `value_type` objects in this set 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 set contains no `value_type` objects equivalent to `key`, then the two returned iterators will have the same value. Note that since a set maintains unique keys, the range will contain at most one element.

Note: implemented inline due to Sun CC compilation error.

== Return Value

pair of const iterators delimiting the equivalent range

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key*
| key value to look up
|===


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