public member function
<set>

std::multiset::cbegin

const_iterator cbegin() const noexcept;
返回指向开头的 const_iterator
返回一个const_iterator指向容器中的第一个元素。

All iterators in multiset containers are constant iterators (including bothconst_iteratoriteratormember types). These cannot be used to modify the contents they point to, but can be increased and decreased normally (unless they are themselves also const).

If the container is empty, the returned iterator value shall not be dereferenced.

参数



返回值

Aconst_iterator指向序列的开头。

成员类型const_iterator是一个指向 const 元素的 双向迭代器 类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// multiset::cbegin/cend
#include <iostream>
#include <set>

int main ()
{
  std::multiset<int> mymultiset = {10,20,30,20,10};

  std::cout << "mymultiset contains:";
  for (auto it=mymultiset.cbegin(); it != mymultiset.cend(); ++it)
    std::cout << ' ' << *it;

  std::cout << '\n';

  return 0;
}

输出
mymultiset contains: 10 10 20 20 30


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器。
同时访问 multiset 的元素是安全的。

异常安全

无异常保证:此成员函数从不抛出异常。
还可以保证返回的迭代器的复制构造或赋值永远不会引发异常。

另见