[#bsl-multimap-0ae-lower_bound-0b]
= xref:bsl.adoc[bsl]::xref:bsl/multimap-0ae.adoc[multimap]::lower&lowbar;bound
:relfileprefix: ../../
:mrdocs:

Return an iterator providing non&hyphen;modifiable access to the first (i&period;e&period;, ordered least) `value&lowbar;type` object in this multimap whose key is greater&hyphen;than or equal&hyphen;to the specified `key`, and the past&hyphen;the&hyphen;end iterator if this multimap does not contain a `value&lowbar;type` object whose key is greater&hyphen;than or equal&hyphen;to `key`&period; Note that this function returns the _first_ position before which a `value&lowbar;type` object having an equivalent key could be inserted into the ordered sequence maintained by this multimap, while preserving its ordering&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class LOOKUP&lowbar;KEY&gt;
xref:bsl/multimap-0ae/const_iterator.adoc[const&lowbar;iterator]
lower&lowbar;bound(LOOKUP&lowbar;KEY const& key) const
requires BloombergLP&colon;&colon;bslmf&colon;&colon;IsTransparentPredicate&lt;COMPARATOR,
                                                   LOOKUP&lowbar;KEY&gt;&colon;&colon;value;
----

== Description

Note&colon; implemented inline due to Sun CC compilation error&period;


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