LvArray::python::PyObjectRef< T > Class Template Reference

A class that manages an owned Python reference with RAII semantics. More...

#include <pythonHelpers.hpp>

Public Member Functions
	PyObjectRef ()=default
	Create an uninitialized (nullptr) reference.
	PyObjectRef (T *const src)
	Take ownership of a reference to src. More...
	PyObjectRef (PyObjectRef const &src)
	Create a new reference to src. More...
	PyObjectRef (PyObjectRef &&src)
	Steal a reference from src. More...
	~PyObjectRef ()
	Destructor, decreases the reference count.
PyObjectRef &	operator= (PyObjectRef const &src)
	Create a new reference to src. More...
PyObjectRef &	operator= (PyObjectRef &&src)
	Steal a reference from src. More...
PyObjectRef &	operator= (PyObject *src)
	Decrease the reference count to the current object and take ownership of a new reference. More...
	operator T* ()
	Conversion operator to a T *. More...
T *	get () const
	Return a pointer to the managed object. More...
T **	getAddress ()
	Return the address of the pointer to the manged object. More...
T *	release ()
	Return the address of the managed object and release ownership. More...

Private Attributes
T *	m_object = nullptr
	A pointer to the manged object.

Detailed Description

template<typename T = PyObject>
class LvArray::python::PyObjectRef< T >

A class that manages an owned Python reference with RAII semantics.

Template Parameters

T	The type of the managed object, must be castable to a PyObject.

Constructor & Destructor Documentation

PyObjectRef() [1/3]

template<typename T = PyObject>

LvArray::python::PyObjectRef< T >::PyObjectRef ( T *const  src )

inline

Take ownership of a reference to src.

Parameters

src	The object to be referenced.

Note

Does not increase the reference count.

PyObjectRef() [2/3]

template<typename T = PyObject>

LvArray::python::PyObjectRef< T >::PyObjectRef ( PyObjectRef< T > const &  src )

inline

Create a new reference to src.

Parameters

src	The object to create a new reference to.

Note

Increases the reference count.

PyObjectRef() [3/3]

template<typename T = PyObject>

LvArray::python::PyObjectRef< T >::PyObjectRef ( PyObjectRef< T > &&  src )

inline

Steal a reference from src.

Parameters

src	The object to steal a reference to.

Note

Does not increase the reference count.

Member Function Documentation

get()

template<typename T = PyObject>

T* LvArray::python::PyObjectRef< T >::get ( ) const

inline

Return a pointer to the managed object.

Returns

A pointer to the managed object.

getAddress()

template<typename T = PyObject>

T* * LvArray::python::PyObjectRef< T >::getAddress ( )

inline

Return the address of the pointer to the manged object.

Returns

The address of the pointer to the manged object.

Useful for functions which take a PyObject** as an output parameter and fill it with a new reference.

operator T*()

template<typename T = PyObject>

LvArray::python::PyObjectRef< T >::operator T* ( )

inline

Conversion operator to a T *.

Returns

A pointer to the managed object.

operator=() [1/3]

template<typename T = PyObject>

PyObjectRef& LvArray::python::PyObjectRef< T >::operator= ( PyObjectRef< T > const &  src )

inline

Create a new reference to src.

Parameters

src	The object to create a new reference to.

Returns

*this.

Note

Increases the reference count.

operator=() [2/3]

template<typename T = PyObject>

PyObjectRef& LvArray::python::PyObjectRef< T >::operator= ( PyObjectRef< T > &&  src )

inline

Steal a reference from src.

Parameters

src	The object to steal a reference to.

Returns

*this.

Note

Does not increase the reference count.

operator=() [3/3]

template<typename T = PyObject>

PyObjectRef& LvArray::python::PyObjectRef< T >::operator= ( PyObject *  src )

inline

Decrease the reference count to the current object and take ownership of a new reference.

Parameters

src	The new object to be referenced.

Returns

*this.

release()

template<typename T = PyObject>

T* LvArray::python::PyObjectRef< T >::release ( )

inline

Return the address of the managed object and release ownership.

Returns

The address of the managed object and release ownership.

Useful for functions which return a PyObject *.

---

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

• /home/docs/checkouts/readthedocs.org/user_builds/lvarray/checkouts/latest/src/python/pythonHelpers.hpp