[#bsl-map-0c7-lower_bound-08]
= xref:bsl.adoc[bsl]::xref:bsl/map-0c7.adoc[map&lt;int, pair&lt;shared&lowbar;ptr&lt;Statistics&gt;, shared&lowbar;ptr&lt;Collector&lt;OsLinux&gt;&gt;&gt;&gt;]::lower&lowbar;bound
:relfileprefix: ../../
:mrdocs:

Return an iterator providing modifiable access to the first (i&period;e&period;, ordered least) `value&lowbar;type` object in this map whose key is greater&hyphen;than or equal&hyphen;to the specified `key`, and the past&hyphen;the&hyphen;end iterator if this map 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 map, while preserving its ordering&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/map-0c7/iterator.adoc[iterator]
lower&lowbar;bound(xref:bsl/map-0c7/key_type.adoc[key&lowbar;type] const& key);
----


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