====================
custom_call_policies
====================

----------
Definition
----------

``custom_call_policies`` is a special call policy, which allows you to integrate
the call policies, you defined, with :doc:`Py++ <../../../pyplusplus>`

-------
Example
-------

.. code-block:: python

  from pyplusplus import module_builder
  from pyplusplus.module_builder import call_policies

  mb = module_builder.module_builder_t( ... )
  mb.free_function( ... ).call_policies \
      = call_policies.custom_call_policies( <<<your call policies code>>> )

  Optionally you can specify name of the header file, which should be included:

.. code-block:: python

   mb.free_function( ... ).call_policies \
      = call_policies.custom_call_policies( <<<your call policies code>>>, "xyz.hpp" )


.. _`Boost.Python`: http://www.boost.org/libs/python/doc/index.html
.. _`Python`: http://www.python.org
.. _`GCC-XML`: http://www.gccxml.org

