public member function
<map>

std::multimap::cbegin

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

Aconst_iterator是一个指向常量内容的迭代器。这个迭代器可以像iteratormultimap::begin 返回,但即使 multimap 对象本身不是 const,也不能用于修改它所指向的内容。

如果容器为空,则不应对返回的迭代器值进行解引用。

参数



返回值

Aconst_iterator指向序列的开头。

成员类型const_iterator双向迭代器 类型,指向 const 元素(类型为const value_type).
请注意,value_typemultimap 容器中是pair<const key_type, mapped_type> 的别名.

示例

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

int main ()
{
  std::multimap<char,int> mymultimap = { {'x',100}, {'y',200}, {'x',300} };

  // print content:
  std::cout << "mymultimap contains:";
  for (auto it = mymultimap.cbegin(); it != mymultimap.cend(); ++it)
    std::cout << " [" << it->first << ':' << it->second << ']';
  std::cout << '\n';

  return 0;
}

输出
mymultimap contains: [x:100] [x:300] [y:200]


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器。
调用不访问任何容器中的元素,但返回的迭代器可用于访问它们。并发访问或修改不同元素是安全的。

异常安全

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

另见