bsl::set::upper_bound

Synopsis

Declared in <bslstl_set.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 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

iterator to the upper bound, or end()

Parameters

Name	Description
key	key value to look up