.. index:: py::builtins::range::find

.. _doxycast_pypp_classpy_1_1builtins_1_1range_1a8e7b2c0f9ac145037b67bf702daab51a:

.. _py-builtins-range-find:

*py::builtins::range::*\ find
=============================

.. code-block:: cpp

     constexpr const_iterator find(const type& value) const;

Finds the given value and returns an iterator to it, otherwise
returns ``this->end()``.


Parameter
---------

``value``: The value to look for.


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

Returns an iterator to the given value if found, otherwise
``this->end()``.


Complexity
----------

Constant.


Example
-------

.. code-block:: cpp

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

     int main()
     {
         py::range<int> nums(1, 10);
         py::print(*nums.find(5));
     }

**Output**:

.. code-block:: text

     5