public member function
<map>

std::map::cend

const_iterator cend() const noexcept;
返回指向结尾的 const_iterator
返回一个const_iterator指向容器的尾后元素。

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

如果容器是 empty 的,此函数返回的内容与 map::cbegin 相同。

返回的值不应被解引用。

参数



返回值

Aconst_iterator指向序列末尾的元素。

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

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 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]


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

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

异常安全

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

另见