bsl::multimap::upper_bound

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

Synopsis

Declared in <bslstl_multimap.h>

iterator
upper_bound(key_type const& key);

Description

Return an iterator providing modifiable access to the first (i.e., ordered least) value_type object in this multimap whose key is greater than the specified key, and the past-the-end iterator if this multimap 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 multimap, while preserving its ordering.

Note: implemented inline due to Sun CC compilation error.

Return Value

iterator to the upper bound, or end()

Parameters

NameDescription
keykey value to look up