std::upper_bound
来自cppreference.com
                    
                                        
                    
                    
                                                            
                    | 
   | 
  该页由英文版wiki使用Google Translate机器翻译而来。 
 该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里.  | 
|   定义于头文件  <algorithm>
  | 
||
|   template< class ForwardIt, class T > ForwardIt upper_bound( ForwardIt first, ForwardIt last, const T& value );  | 
(1) | |
|   template< class ForwardIt, class T, class Compare > ForwardIt upper_bound( ForwardIt first, ForwardIt last, const T& value, Compare comp );  | 
(2) | |
返回一个迭代器,它指向[first, last)区间内第一个大于value的元素。第一个版本使用operator<比较元素,第二个版本使用指定的比较函数comp。
目录 | 
[编辑] 参数
| first, last | - | 要比较的元素的区间 | 
| value | - | 要比较的值 | 
| comp | - |   比较函数,如果第一个参数小于第二个参数,返回true。 该函数的签名形式如下: bool cmp(const Type1 &a, const Type2 &b); 虽然函数签名中const &不是必须的,但是函数必须保证不会修改传递给它的对象。  | 
| 类型要求 | ||
 -ForwardIt必须满足 ForwardIterator的要求。
 | ||
[编辑] 返回值
一个迭代器,它指向第一个大于value的元素;如果找不到,返回last。
[编辑] 可能的实现
| 版本一 | 
|---|
template<class ForwardIt, class T> ForwardIt upper_bound(ForwardIt first, ForwardIt last, const T& value) { ForwardIt it; std::iterator_traits<ForwardIt>::distance_type count, step; count = std::distance(first,last); while (count > 0) { it = first; step = count / 2; std::advance(it, step); if (!(value < *it)) { first = ++it; count -= step + 1; } else count = step; } return first; }  | 
| 版本二 | 
template<class ForwardIt, class T, class Compare> ForwardIt upper_bound(ForwardIt first, ForwardIt last, const T& value, Compare comp) { ForwardIt it; std::iterator_traits<ForwardIt>::distance_type count, step; count = std::distance(first,last); while (count > 0) { it = first; step = count / 2; std::advance(it, step); if (!comp(value, *it)), first = ++it; count -= step + 1 } else count = step; } return first; }  | 
[编辑] 示例
#include <algorithm> #include <iostream> #include <iterator> #include <vector> int main() { std::vector<int> data = { 1, 1, 2, 3, 3, 3, 3, 4, 4, 4, 5, 5, 6 }; auto lower = std::lower_bound(data.begin(), data.end(), 4); auto upper = std::upper_bound(data.begin(), data.end(), 4); std::copy(lower, upper, std::ostream_iterator<int>(std::cout, " ")); }
输出:
4 4 4
[编辑] 复杂度
first和last之间的距离的对数
[编辑] 另请参阅
|    返回匹配特定键值的元素区间   (函数模板)  | |
|    返回指向第一个不小于给定值的元素的迭代器   (函数模板)  |