.. index:: py::builtins::operator == [py::builtins::list]

.. _doxycast_pypp_namespacepy_1_1builtins_1a36fdbbf7f47133177540feb0badf97d6:

.. _py-builtins-operator-equals-list:

*py::builtins::*\ operator == (:ref:`py::builtins::list <py-builtins-list>`)
============================================================================

*Defined in* ``<pypp/builtins/list.hpp>``

.. code-block:: cpp

     template <class type, class allocator_a, class allocator_b>
     bool operator == (const list<type, allocator_a>& lhs, const list<type, allocator_b>& rhs);

Compares two lists for equality.


Parameters
----------

``lhs``: A list.

``rhs``: Another list.


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

Whether ``lhs`` is equal to ``rhs``.


Complexity
----------

:math:`O(n)`, where ``n = py::min(lhs.size(), rhs.size())``.


Example
-------

.. code-block:: cpp

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

     int main()
     {
         py::list<int> lhs{0, 9, 2, 3};
         py::list<int> rhs{0, 9, 2, 3};

         py::print(lhs == rhs);
     }

**Output**:

.. code-block:: text

     true