Return an iterator to the first element with key greater than key.

Synopsis

Declared in <bslstl_map.h>

template<class LOOKUP_KEY>
iterator
upper_bound(LOOKUP_KEY const& key)
requires BloombergLP::bslmf::IsTransparentPredicate<COMPARATOR,
                                                   LOOKUP_KEY>::value;

Description

Return an iterator providing 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

iterator to the upper bound, or end()

Parameters

Name

Description

key

key value to look up

Created with MrDocs