公有成员函数
<set>

std::multiset::upper_bound

iterator upper_bound (const value_type& val) const;
const_iterator upper_bound (const value_type& val) const;      iterator upper_bound (const value_type& val);
返回指向上界的迭代器
返回一个迭代器,该迭代器指向容器中被认为在 val 之后的第一个元素。

该函数使用其内部的 比较对象 (key_comp) 来确定这一点,返回第一个满足以下条件的元素的迭代器:key_comp(val,element)返回true.

如果 multiset 类是用默认比较类型 (less) 实例化的,则该函数返回一个大于 val 的第一个元素的迭代器。

一个类似的成员函数 lower_bound 的行为与upper_bound相同,除了在 multiset 包含等同于 val 的元素时:在这种情况下 lower_bound 返回指向这些元素中第一个的迭代器,而upper_bound返回指向最后一个元素之后那个元素的迭代器。

参数

val
要比较的值。
成员类型value_type是容器中元素的类型,在 multiset 中定义为第一个模板参数的别名(T).

返回值

指向容器中被认为在 val 之后的第一个元素的迭代器,如果没有任何元素被认为在 val 之后,则返回 multiset::end

成员类型iteratorconst_iterator双向迭代器 类型,指向元素。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// multiset::lower_bound/upper_bound
#include <iostream>
#include <set>

int main ()
{
  std::multiset<int> mymultiset;
  std::multiset<int>::iterator itlow,itup;

  for (int i=1; i<8; i++) mymultiset.insert(i*10); // 10 20 30 40 50 60 70

  itlow = mymultiset.lower_bound (30);             //       ^
  itup = mymultiset.upper_bound (40);              //             ^

  mymultiset.erase(itlow,itup);                    // 10 20 50 60 70

  std::cout << "mymultiset contains:";
  for (std::multiset<int>::iterator it=mymultiset.begin(); it!=mymultiset.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  return 0;
}

请注意,lower_bound(30)返回指向30的迭代器,而upper_bound(60)返回指向70.
mymultiset contains: 10 20 50 60 70


复杂度

size 取对数。

迭代器有效性

没有变化。

数据竞争

访问容器(const 和非 const 版本都不会修改容器)。
同时访问 multiset 的元素是安全的。

异常安全

强保证:如果抛出异常,容器没有发生变化。

另见