C++官网参考链接:https://cplusplus.com/reference/map/map/cend/
公有成员函数
<map>
std::map::cend
const_iterator cend() const noexcept;
返回指向结束的const_iterator
返回一个指向容器结束后元素的const_iterator。
const_iterator是指向const内容的iterator。这个iterator可以增加或减少(除非它本身也是const),就像map::end返回的iterator一样,但不能用来修改它所指向的内容,即使map对象本身不是const。
如果容器为empty,此函数返回与map::cbegin相同的内容。
返回的值不应该解引用。
形参
没有形参。
返回值
指向序列结束后的元素的const_iterator。
成员类型const_iterator是指向const元素的双向iterator(bidirectional iterator)类型。
用例
// 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;
}
输出:
复杂度
常量。
iterator的有效性
没有变化。
数据竞争
访问容器。
调用不访问包含的元素,但返回的iterator可用于访问它们。同时访问或修改不同的元素是安全的。
异常安全
无抛出保证:该成员函数从不抛出异常。
返回的iterator的复制构造或赋值也保证永远不会抛出。