.. index:: py::builtins::list::append

.. _doxycast_pypp_classpy_1_1builtins_1_1list_1ad0de2085023c26b41d9ee44bdeed2520:

.. _py-builtins-list-append:

*py::builtins::list::*\ append
==============================

.. code-block:: cpp

     void append(const_reference element);                   // 1

     void append(value_type&& element);                      // 2

Appends given element to the list.


Parameters
----------

``element``: The element to append.


Complexity
----------

Constant, plus linear in the size of the list if the insertion
causes the memory to be reallocated.


Example
-------

.. code-block:: cpp

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

     int main()
     {
         py::list<int> list = {0, 1};

         py::print(list);

         list.append(2);

         py::print(list);
     }

**Output**:

.. code-block:: text

     {0, 1}
     {0, 1, 2}