[#BloombergLP-bslstl-HashTable-find-06]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/HashTable.adoc[HashTable]::find
:relfileprefix: ../../../
:mrdocs:

Return the address of a node with a key equivalent to `key`, or null.

== Synopsis

Declared in `<bslstl_hashtable.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class LOOKUP_KEY>
xref:BloombergLP/bslalg/BidirectionalLink.adoc[bslalg::BidirectionalLink]*
find(LOOKUP_KEY const& key) const
requires BloombergLP::bslmf::IsTransparentPredicate<HASHER,    LOOKUP_KEY>::value
   && BloombergLP::bslmf::IsTransparentPredicate<COMPARATOR,LOOKUP_KEY>::value;
----

== Description

Return the address of a link whose key is equivalent to the specified `key` (according to this hash‐table's `comparator`), and a null pointer value if no such link exists. If this hash‐table contains more than one element having the supplied `key`, return the first such element (from the contiguous sequence of elements having the same key). The behavior is undefined unless `key` is equivalent to the elements of at most one equivalent‐key group.

== Return Value

address of a matching node, or null if none exists

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key*
| transparent key to search for
|===


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