.. index:: py::builtins::list::cend

.. _doxycast_pypp_classpy_1_1builtins_1_1list_1a76155b3f53d358fa040628e707175dc4:

.. _py-builtins-list-cend:

*py::builtins::list::*\ cend
============================

.. code-block:: cpp

     const_iterator cend() const;

Returns a constant iterator to one past the last element.

.. graphviz:: ../assets/range-begin-end.dot


Return value
------------

A constant iterator to one past the last element.


Complexity
----------

Constant.


Example
-------

.. code-block:: cpp

     #include <pypp/builtins/list.hpp>
     #include <pypp/builtins/print.hpp>

     int main()
     {
         py::list<int> list = {0, 0, 1, 3};
         py::print(*(list.cend() - 1));
     }

**Output**:

.. code-block:: text

     3