[#bsl-set-0d-lower_bound-02]
= xref:bsl.adoc[bsl]::xref:bsl/set-0d.adoc[set]::lower&lowbar;bound
:relfileprefix: ../../
:mrdocs:

Return an iterator to the first element not less than `key`&period;

== Synopsis

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

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

== Description

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

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

== Return Value

iterator to the lower bound, or `end()`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key*
| key value to look up
|===


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