public member function
<set>

std::multiset::lower_bound

iterator lower_bound (const value_type& val) const;
const_iterator lower_bound (const value_type& val) const;      iterator lower_bound (const value_type& val);
返回指向不小於 val 的第一個元素的迭代器
返回一個迭代器,指向容器中第一個不被認為在 val 之前的元素(即,該元素等於 val 或在 val 之後)。

該函式使用其內部的 比較物件key_comp)來確定這一點,返回一個指向第一個滿足以下條件的元素的迭代器:key_comp(element,val)返回false.

如果 multiset 類使用預設比較型別(less)進行例項化,則該函式返回一個指向第一個不小於 val 的元素的迭代器。

一個類似的成員函式 upper_bound 的行為與此相同,lower_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(40)返回指向50.
mymultiset contains: 10 20 50 60 70


複雜度

size 取對數。

迭代器有效性

沒有變化。

資料競爭

訪問容器(const 和非 const 版本都不會修改容器)。
同時訪問 multiset 的元素是安全的。

異常安全

強保證:如果丟擲異常,容器沒有發生變化。

另見