std::

list::cend

公众成员函数  <list>
返回一个指向容器末尾元素的下一个元素的常量迭代器

返回指向容器中 past-the-end元素的const_iterator对象。

const_iterator是指向const内容的迭代器。这个迭代器可以增减(除非它本身也是const)， 就像list::end返回的迭代器一样，但它不能用于修改它所指向的内容，即使list对象本身不是const。

如果容器为空，则该函数返回与list::cbegin相同的结果。

返回的值不能解引用。

☲  参数

---

none

☉  返回值

---

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

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

☣  示例

---

// list::cbegin/cend #include <iostream> #include <list> int main () { std::list<int> mylist = {5,10,15,20}; std::cout << "mylist contains:"; for (auto it = mylist.cbegin(); it != mylist.cend(); ++it) std::cout << ' ' << *it; std::cout << '\n'; return 0; }

✥ 复杂度

---

常量

☣ 迭代器的有效性

---

不变

⇄ 数据竞争

---

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

☂ 异常安全性

---

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

🍄  另请参阅

---

list::end	返回一个指向容器末尾元素的下一个元素的迭代器(公众成员函数)
list::cbegin	返回指向容器第一个元素的常量迭代器(公众成员函数)