bsl::map::upper_bound

Return a const iterator to the first element with key greater than key.

Synopsis

Declared in <bslstl_map.h>

const_iterator
upper_bound(key_type const& key) const;

Description

Return an iterator providing non-modifiable access to the first (i.e., ordered least) value_type object in this map whose key is greater than the specified key, and the past-the-end iterator if this map does not contain a value_type object whose key is greater-than key. Note that this function returns the last position before which a value_type object having an equivalent key could be inserted into the ordered sequence maintained by this map, while preserving its ordering.

Return Value

const iterator to the upper bound, or end()

Parameters

NameDescription
keykey value to look up