C++ algorithm upper_bound() function
Example
Find the first value greater than 7 in a sorted vector:
vector<int> numbers = {1, 7, 3, 5, 9, 2};
sort(numbers.begin(), numbers.end());
auto it = upper_bound(numbers.begin(), numbers.end(), 7);
if(it != numbers.end()) {
cout << *it << " is the first value greater than 7";
} else {
cout << "No elements found above the upper bound";
}
Definition and Usage
The upper_bound() function is an efficient algorithm to find the first value in a sorted data range that is above a specified upper bound.
If the data range is not already sorted then the function may return an incorrect result. The sort() function can be used to sort elements in the data range.
The range of data is specified by iterators.
Syntax
upper_bound(iterator start, iterator end, <type> bound);<type> refers to the type of the data that the range contains.
Parameter Values
| Parameter | Description |
|---|---|
| start | Required. An iterator pointing to the start of the data range. |
| end | Required. An iterator pointing to the end of the data range. Elements up to this position will be included, but the element at this position will not be. |
| bound | Required. Specifies the upper bound. |
Technical Details
| Returns: | An iterator pointing to the element containing the first value which is above the upper bound. If no element can be found then it returns the end of the data range. |
|---|
Related Pages
Read more about data structures in our Data Structures Tutorial.
Read more about iterators in our Iterators Tutorial.
Read more about algorithms in our Algorithms Tutorial.
