.. index:: py::builtins::list::rend

.. _doxycast_pypp_classpy_1_1builtins_1_1list_1a31c24e3701f71782fda72dcbd3b1577d:

.. _py-builtins-list-rend:

*py::builtins::list::*\ rend
============================

.. code-block:: cpp

     reverse_iterator rend();                                // 1

     const_reverse_iterator rend() const;                    // 2

1.   Returns a reverse iterator to one past the last element of
     the reversed list.

2.   Returns a constant reverse iterator to one past the last
     element of the reversed list.

.. tip::

     \(2) is equivalent to :ref:`py-builtins-list-crend`.

.. graphviz:: ../assets/range-rbegin-rend.dot


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

1.   An reverse iterator to one past the last element of the
     reversed list.

2.   A constant reverse iterator to one past the last element of
     the reversed list.


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.rend() - 1));
     }

**Output**:

.. code-block:: text

     0