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

Load `first` and `last` with the range of nodes matching `key`.

== Synopsis

Declared in `<bslstl_hashtable.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
findRange(
    xref:BloombergLP/bslalg/BidirectionalLink.adoc[bslalg::BidirectionalLink]** first,
    xref:BloombergLP/bslalg/BidirectionalLink.adoc[bslalg::BidirectionalLink]** last,
    xref:BloombergLP/bslstl/HashTable/KeyType.adoc[KeyType] const& key) const;
----

== 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 compares equal to the specified `key` using the `comparator` of this hash‐table, and null pointer values if there are no elements matching `key`. 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‐open range where `last` would point to the element following the range). Also note that this hash‐table ensures all elements having the same key form a contiguous sequence.

== 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*
| key whose matching range is located
|===


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