.. index:: py::builtins::range::rbegin

.. _doxycast_pypp_classpy_1_1builtins_1_1range_1ae7c4bf75b2f7fdd6b2cc6bebc57e6c3d:

.. _py-builtins-range-rbegin:

*py::builtins::range::*\ rbegin
===============================

.. code-block:: cpp

     constexpr const_reverse_iterator rbegin() const;

Returns a constant reverse iterator to the first value of the
reversed range.

.. warning::

     Iterators of ``range`` don't support ``operator ->`` as they
     are constructed on demand.

.. tip::

     Equivalent to :ref:`py-builtins-range-crbegin`.

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


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

A constant reverse iterator to the first value of the reversed
range.


Complexity
----------

Constant.


Example
-------

.. code-block:: cpp

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

     int main()
     {
         py::range<int> range(4);
         py::print(*range.rbegin());
     }

**Output**:

.. code-block:: text

     3