map::cbegin-c和c++中文资料站

C&C++标准库

std::

map::cbegin

公众成员函数 <map>

const_iterator cbegin() const noexcept;

返回指向容器第一个元素的常量迭代器

返回指向容器第一个元素的const_iterator对象。

const_iterator是指向const内容的迭代器。与map::begin返回的迭代器一样，该迭代器可以加或减(除非它本身也是const对象)，但不能用于修改它所指向的内容，即使map对象本身不是const对象。

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

☲ 参数

none

☉ 返回值

返回指向容器第一个元素的常量迭代器.

成员类型const_iterator是指向const元素(const value_type类型)的双向迭代器类型。注意，映射容器中的value_type是pair<const key_type, mapped_type>的别名。

☣ 示例

// map::cbegin/cend
#include <iostream>
#include <map>

int main ()
{
  std::map<char,int> mymap;

  mymap['b'] = 100;
  mymap['a'] = 200;
  mymap['c'] = 300;

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

  return 0;
}

输出:
mymap contains: [a:200] [b:100] [c:300]

✥ 复杂度

常量

☣ 迭代器的有效性

不变

⇄ 数据竞争

容器被访问。
调用不能访问包含的元素，但可以使用返回的迭代器访问这些元素。同时访问或修改不同的元素是安全的。

☂ 异常安全性

No-throw保证:这个成员函数从不抛出异常。
返回迭代器的复制构造或赋值也保证不会引发抛出。

🍄 另请参阅

map::begin	返回指向map容器第一个元素的迭代器(公众成员函数)
map::cend	返回一个指向容器末尾元素的下一个元素的常量迭代器(公众成员函数)
map::crbegin	返回指向容器中最后一个元素的常量反向迭代器(公众成员函数)