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

Synopsis

Declared in <bslstl_set.h>

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

Description

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

Note: implemented inline due to Sun CC compilation error.

Return Value

const iterator to the upper bound, or end()

Parameters

Name

Description

key

key value to look up

Created with MrDocs