[#BloombergLP-bslstl-HashTable-findRange-0b]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/HashTable.adoc[HashTable]::findRange
:relfileprefix: ../../../
:mrdocs:

Load `first` and `last` with the transparent key matching range&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;hashtable&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class LOOKUP&lowbar;KEY&gt;
void
findRange(
    xref:BloombergLP/bslalg/BidirectionalLink.adoc[bslalg::BidirectionalLink]** first,
    xref:BloombergLP/bslalg/BidirectionalLink.adoc[bslalg::BidirectionalLink]** last,
    LOOKUP&lowbar;KEY const& key) const
requires BloombergLP&colon;&colon;bslmf&colon;&colon;IsTransparentPredicate&lt;HASHER,    LOOKUP&lowbar;KEY&gt;&colon;&colon;value
   &amp;&amp; BloombergLP&colon;&colon;bslmf&colon;&colon;IsTransparentPredicate&lt;COMPARATOR,LOOKUP&lowbar;KEY&gt;&colon;&colon;value;
----

== Description

Load into the specified `first` and `last` pointers the respective addresses of the first and last link (in the list of elements owned by this hash table) where the contained elements have a key that is equivalent to the specified `key` using the `comparator` of this hash&hyphen;table, and null pointer values if there are no elements matching `key`&period; The behavior is undefined unless `key` is equivalent to the elements of at most one equivalent&hyphen;key group&period; Note that the output values will form a closed range, where both `first` and `last` point to links satisfying the predicate (rather than a semi&hyphen;open range where `last` would point to the element following the range)&period; Also note that this hash&hyphen;table ensures all elements having the same key form a contiguous sequence&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *first*
| set to the address of the first matching node
| *last*
| set to the address of the last matching node
| *key*
| transparent key whose matching range is located
|===


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