[#bsl-map-0af-upper_bound-00]
= xref:bsl.adoc[bsl]::xref:bsl/map-0af.adoc[map&lt;TimeInterval, Node*&gt;]::upper&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 map whose key is greater than 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 `key`&period; Note that this function returns the _last_ 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-0af/const_iterator.adoc[const&lowbar;iterator]
upper&lowbar;bound(xref:bsl/map-0af/key_type.adoc[key&lowbar;type] const& key) const;
----


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