Home C&C++函数库 c++ 语法 程序源码 Linux C库

std::

multimap::cbegin

公众成员函数  <map>
const_iterator cbegin() const noexcept;

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

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

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

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

☲  参数


none

☉  返回值



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

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

☣  示例



// 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]

✥ 复杂度



常量

☣ 迭代器的有效性



不变

⇄ 数据竞争


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

☂ 异常安全性



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

🍄  另请参阅



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

联系我们 免责声明 关于CandCplus 网站地图