module_ Class Reference

Wrapper for Python extension modules. More...

#include <pybind11.h>

Inheritance diagram for module_:

Public Member Functions
PYBIND11_NOINLINE void	add_object (const char *name, handle obj, bool overwrite=false)
template<typename Func , typename... Extra>
module_ &	def (const char *name_, Func &&f, const Extra &...extra)
module_	def_submodule (const char *name, const char *doc=nullptr)
	module_ (const char *name, const char *doc=nullptr)
	Create a new top-level Python module with the given name and docstring. More...
void	reload ()
	Reload the module or throws error_already_set. More...
Public Member Functions inherited from object
template<typename T >
T	cast () const &
template<typename T >
T	cast ()&&
template<>
void	cast () const &
template<>
void	cast ()&&
	object ()=default
	object (const object &o)
	Copy constructor; always increases the reference count. More...
	object (object &&other) noexcept
	Move constructor; steals the object from other and preserves its reference count. More...
	object (handle h, borrowed_t)
	object (handle h, stolen_t)
object &	operator= (const object &other)
object &	operator= (object &&other) noexcept
	PYBIND11_DEPRECATED ("Use reinterpret_borrow<object>() or reinterpret_steal<object>()") object(handle h
handle	release ()
	~object ()
	Destructor; automatically calls handle::dec_ref() More...
Public Member Functions inherited from handle
template<typename T >
T	cast () const
template<>
void	cast () const
bool	check () const
const handle &	dec_ref () const &
	handle ()=default
	The default constructor creates a handle with a nullptr-valued pointer. More...
	handle (PyObject *ptr)
	Creates a handle from the given raw Python object pointer. More...
const handle &	inc_ref () const &
	operator bool () const
	Return true when the handle wraps a valid Python object. More...
bool	operator!= (const handle &h) const
bool	operator== (const handle &h) const
PyObject *	ptr () const
	Return the underlying PyObject * pointer. More...
PyObject *&	ptr ()

Static Public Member Functions
static module_	import (const char *name)
	Import and return a module or throws error_already_set. More...

Additional Inherited Members
Public Attributes inherited from object
bool	is_borrowed: handle(h) { if (is_borrowed) inc_ref()
Protected Attributes inherited from handle
PyObject *	m_ptr = nullptr

Detailed Description

Wrapper for Python extension modules.

Definition at line 855 of file pybind11.h.

Constructor & Destructor Documentation

module_::module_ ( const char *  name, const char *  doc = nullptr  )

inlineexplicit

Create a new top-level Python module with the given name and docstring.

Definition at line 860 of file pybind11.h.

Member Function Documentation

PYBIND11_NOINLINE void module_::add_object ( const char *  name, handle  obj, bool  overwrite = false  )

inline

Definition at line 934 of file pybind11.h.

template<typename Func , typename... Extra>

module_& module_::def ( const char *  name_, Func &&  f, const Extra &...  extra  )

inline

Create Python binding for a new function within the module scope. Func can be a plain C++ function, a function pointer, or a lambda function. For details on the Extra&& ... extra argument, see section :ref:extras.

Definition at line 884 of file pybind11.h.

module_ module_::def_submodule ( const char *  name, const char *  doc = nullptr  )

inline

Create and return a new Python submodule with the given name and docstring. This also works recursively, i.e.

.. code-block:: cpp

py::module m("example", "pybind11 example plugin");
py::module m2 = m.def_submodule("sub", "A submodule of 'example'");
py::module m3 = m2.def_submodule("subsub", "A submodule of 'example.sub'");

Definition at line 903 of file pybind11.h.

static module_ module_::import ( const char *  name )

inlinestatic

Import and return a module or throws error_already_set.

Definition at line 914 of file pybind11.h.

void module_::reload ( )

inline

Reload the module or throws error_already_set.

Definition at line 922 of file pybind11.h.

---

The documentation for this class was generated from the following file:

• pybind11.h