#include "detail/common.h"
#include "buffer_info.h"
#include <assert.h>
#include <cstddef>
#include <exception>
#include <frameobject.h>
#include <iterator>
#include <memory>
#include <string>
#include <type_traits>
#include <typeinfo>
#include <utility>

Include dependency graph for pytypes.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	accessor< Policy >

class	accessor< Policy >

class	anyset

class	args

class	args_proxy

struct	arrow_proxy< T >
	Quick proxy class needed to implement `operator->` for iterators which can't return pointers. More...

class	bool_

struct	object::borrowed_t

class	buffer

class	bytearray

class	bytes

class	capsule

class	dict

class	dict_readonly
	Python's dictionary protocol permits this to be a forward iterator. More...

class	ellipsis

class	error_already_set

struct	error_fetch_and_normalize

class	float_

class	frozenset

class	function

struct	generic_item

class	generic_iterator< Policy >
	STL iterator template used for tuple, list, sequence and dict. More...

class	handle

class	int_

class	iterable

class	iterator

class	kwargs

class	kwargs_proxy

class	list

struct	list_item

class	memoryview

class	none

struct	obj_attr

class	object

class	object_api< Derived >

class	pyobject_tag
	Tag and check to identify a class which implements the Python object API. More...

class	sequence

class	sequence_fast_readonly
	Lightweight iterator policy using just a simple pointer: see `PySequence_Fast_ITEMS` More...

struct	sequence_item

class	sequence_slow_readwrite
	Full read and write access using the sequence protocol: see `detail::sequence_accessor` More...

class	set

class	simple_collector< policy >

class	slice

class	staticmethod

struct	object::stolen_t

class	str

struct	str_attr

class	tuple

struct	tuple_item

class	type

class	unpacking_collector< policy >
	Helper class which collects positional, keyword, * and ** arguments for a Python function call. More...

class	weakref

Namespaces
	accessor_policies

	literals

Macros
#define	PYBIND11_HANDLE_REF_DEBUG

#define	PYBIND11_MATH_OPERATOR_BINARY(op, fn)

#define	PYBIND11_MATH_OPERATOR_UNARY(op, fn)

#define	PYBIND11_OBJECT(Name, Parent, CheckFun)

#define	PYBIND11_OBJECT_CHECK_FAILED(Name, o_ptr)

#define	PYBIND11_OBJECT_COMMON(Name, Parent, CheckFun)

#define	PYBIND11_OBJECT_CVT(Name, Parent, CheckFun, ConvertFun)

#define	PYBIND11_OBJECT_CVT_DEFAULT(Name, Parent, CheckFun, ConvertFun)

#define	PYBIND11_OBJECT_DEFAULT(Name, Parent, CheckFun)

#define	PYBIND11_STR_CHECK_FUN PyUnicode_Check

Typedefs
using	dict_iterator = generic_iterator< iterator_policies::dict_readonly >

template<typename T >
using	is_ds_unpacking = std::is_same< kwargs_proxy, T >

template<typename T >
using	is_keyword = std::is_base_of< arg, T >
	Python argument categories (using PEP 448 terms) More...

template<typename T >
using	is_keyword_or_ds = satisfies_any_of< T, is_keyword, is_ds_unpacking >

template<typename T >
using	is_positional = satisfies_none_of< T, is_keyword, is_s_unpacking, is_ds_unpacking >

template<typename T >
using	is_pyobj_ptr_or_nullptr_t = detail::any_of< std::is_same< T, PyObject * >, std::is_same< T, PyObject *const >, std::is_same< T, std::nullptr_t > >

template<typename T >
using	is_pyobject = std::is_base_of< pyobject_tag, remove_reference_t< T > >

template<typename T >
using	is_s_unpacking = std::is_same< args_proxy, T >

using	item_accessor = accessor< accessor_policies::generic_item >

using	list_accessor = accessor< accessor_policies::list_item >

using	list_iterator = generic_iterator< iterator_policies::sequence_fast_readonly >

using	obj_attr_accessor = accessor< accessor_policies::obj_attr >

using	sequence_accessor = accessor< accessor_policies::sequence_item >

using	sequence_iterator = generic_iterator< iterator_policies::sequence_slow_readwrite >

using	str_attr_accessor = accessor< accessor_policies::str_attr >

using	tuple_accessor = accessor< accessor_policies::tuple_item >

using	tuple_iterator = generic_iterator< iterator_policies::sequence_fast_readonly >

Functions
template<typename... Args>
constexpr bool	args_are_all_keyword_or_ds ()

template<typename Unsigned >
Unsigned	as_unsigned (PyObject *o)

void	delattr (handle obj, handle name)

void	delattr (handle obj, const char *name)

PyObject *	dict_getitem (PyObject v, PyObject key)

PyObject *	dict_getitemstring (PyObject v, const char key)

std::string	error_string ()

handle	get_function (handle value)

object	getattr (handle obj, handle name)

object	getattr (handle obj, const char *name)

object	getattr (handle obj, handle name, handle default_)

object	getattr (handle obj, const char *name, handle default_)

bool	hasattr (handle obj, handle name)

bool	hasattr (handle obj, const char *name)

ssize_t	hash (handle obj)

template<typename T , detail::enable_if_t< std::is_base_of< object, T >::value, int > = 0>
bool	isinstance (handle obj)

bool	isinstance (handle obj, handle type)

template<>
bool	isinstance< handle > (handle)=delete

template<>
bool	isinstance< object > (handle obj)

bool	isinstance_generic (handle obj, const std::type_info &tp)

iterator	iter (handle obj)

size_t	len (handle h)
	Get the length of a Python object. More...

size_t	len_hint (handle h)

const char *	obj_class_name (PyObject *obj)

template<typename T , enable_if_t< is_pyobject< T >::value, int > = 0>
auto	object_or_cast (T &&o) -> decltype(std::forward< T >(o))

template<typename T , enable_if_t<!is_pyobject< T >::value, int > = 0>
object	object_or_cast (T &&o)

handle	object_or_cast (PyObject *ptr)

str	literals::operator"" _s (const char *s, size_t size)

bool	PyEllipsis_Check (PyObject *o)

bool	PyIterable_Check (PyObject *obj)

bool	PyNone_Check (PyObject *o)

bool	PyStaticMethod_Check (PyObject *o)

void	raise_from (PyObject type, const char message)

void	raise_from (error_already_set &err, PyObject type, const char message)

template<typename T >
T	reinterpret_borrow (handle h)

template<typename T >
T	reinterpret_steal (handle h)

str	repr (handle h)

void	setattr (handle obj, handle name, handle value)

void	setattr (handle obj, const char *name, handle value)

Macro Definition Documentation

◆ PYBIND11_HANDLE_REF_DEBUG

#define PYBIND11_HANDLE_REF_DEBUG

Definition at line 201 of file pytypes.h.

◆ PYBIND11_MATH_OPERATOR_BINARY

#define PYBIND11_MATH_OPERATOR_BINARY	(	op,
		fn
	)

Value:

template <typename D>                                                                         \
    object object_api<D>::op(object_api const &other) const {                                     \
        object result = reinterpret_steal<object>(fn(derived().ptr(), other.derived().ptr()));    \
        if (!result.ptr())                                                                        \
            throw error_already_set();                                                            \
        return result;                                                                            \
    }

Definition at line 2358 of file pytypes.h.

◆ PYBIND11_MATH_OPERATOR_UNARY

#define PYBIND11_MATH_OPERATOR_UNARY	(	op,
		fn
	)

Value:

template <typename D>                                                                         \
    object object_api<D>::op() const {                                                            \
        object result = reinterpret_steal<object>(fn(derived().ptr()));                           \
        if (!result.ptr())                                                                        \
            throw error_already_set();                                                            \
        return result;                                                                            \
    }

Definition at line 2349 of file pytypes.h.

◆ PYBIND11_OBJECT

#define PYBIND11_OBJECT	(	Name,
		Parent,
		CheckFun
	)

Value:

PYBIND11_OBJECT_COMMON(Name, Parent, CheckFun)                                                \
    /* This is deliberately not 'explicit' to allow implicit conversion from object: */           \
    /* NOLINTNEXTLINE(google-explicit-constructor) */                                             \
    Name(const object &o) : Parent(o) {                                                           \
        if (m_ptr && !check_(m_ptr))                                                              \
            throw PYBIND11_OBJECT_CHECK_FAILED(Name, m_ptr);                                      \
    }                                                                                             \
    /* NOLINTNEXTLINE(google-explicit-constructor) */                                             \
    Name(object &&o) : Parent(std::move(o)) {                                                     \
        if (m_ptr && !check_(m_ptr))                                                              \
            throw PYBIND11_OBJECT_CHECK_FAILED(Name, m_ptr);                                      \
    }

Definition at line 1276 of file pytypes.h.

◆ PYBIND11_OBJECT_CHECK_FAILED

#define PYBIND11_OBJECT_CHECK_FAILED	(	Name,
		o_ptr
	)

Value:

::pybind11::type_error("Object of type '"                                                     \
                           + ::pybind11::detail::get_fully_qualified_tp_name(Py_TYPE(o_ptr))      \
                           + "' is not an instance of '" #Name "'")

Definition at line 1271 of file pytypes.h.

◆ PYBIND11_OBJECT_COMMON

#define PYBIND11_OBJECT_COMMON	(	Name,
		Parent,
		CheckFun
	)

Value:

public:                                                                                           \
    PYBIND11_DEPRECATED("Use reinterpret_borrow<" #Name ">() or reinterpret_steal<" #Name ">()")  \
    Name(handle h, bool is_borrowed)                                                              \
        : Parent(is_borrowed ? Parent(h, borrowed_t{}) : Parent(h, stolen_t{})) {}                \
    Name(handle h, borrowed_t) : Parent(h, borrowed_t{}) {}                                       \
    Name(handle h, stolen_t) : Parent(h, stolen_t{}) {}                                           \
    PYBIND11_DEPRECATED("Use py::isinstance<py::python_type>(obj) instead")                       \
    bool check() const { return m_ptr != nullptr && (CheckFun(m_ptr) != 0); }                     \
    static bool check_(handle h) { return h.ptr() != nullptr && CheckFun(h.ptr()); }              \
    template <typename Policy_> /* NOLINTNEXTLINE(google-explicit-constructor) */                 \
    Name(const ::pybind11::detail::accessor<Policy_> &a) : Name(object(a)) {}

Definition at line 1239 of file pytypes.h.

◆ PYBIND11_OBJECT_CVT

#define PYBIND11_OBJECT_CVT	(	Name,
		Parent,
		CheckFun,
		ConvertFun
	)

Value:

PYBIND11_OBJECT_COMMON(Name, Parent, CheckFun)                                                \
    /* This is deliberately not 'explicit' to allow implicit conversion from object: */           \
    /* NOLINTNEXTLINE(google-explicit-constructor) */                                             \
    Name(const object &o)                                                                         \
        : Parent(check_(o) ? o.inc_ref().ptr() : ConvertFun(o.ptr()), stolen_t{}) {               \
        if (!m_ptr)                                                                               \
            throw ::pybind11::error_already_set();                                                \
    }                                                                                             \
    /* NOLINTNEXTLINE(google-explicit-constructor) */                                             \
    Name(object &&o) : Parent(check_(o) ? o.release().ptr() : ConvertFun(o.ptr()), stolen_t{}) {  \
        if (!m_ptr)                                                                               \
            throw ::pybind11::error_already_set();                                                \
    }

Definition at line 1252 of file pytypes.h.

◆ PYBIND11_OBJECT_CVT_DEFAULT

#define PYBIND11_OBJECT_CVT_DEFAULT	(	Name,
		Parent,
		CheckFun,
		ConvertFun
	)

Value:

PYBIND11_OBJECT_CVT(Name, Parent, CheckFun, ConvertFun) \

Name() : Parent() {}

PYBIND11_OBJECT_CVT

#define PYBIND11_OBJECT_CVT(Name, Parent, CheckFun, ConvertFun)

Definition: pytypes.h:1252

Definition at line 1267 of file pytypes.h.

◆ PYBIND11_OBJECT_DEFAULT

#define PYBIND11_OBJECT_DEFAULT	(	Name,
		Parent,
		CheckFun
	)

Value:

PYBIND11_OBJECT(Name, Parent, CheckFun) \

Name() : Parent() {}

PYBIND11_OBJECT

#define PYBIND11_OBJECT(Name, Parent, CheckFun)

Definition: pytypes.h:1276

Definition at line 1290 of file pytypes.h.

◆ PYBIND11_STR_CHECK_FUN

#define PYBIND11_STR_CHECK_FUN PyUnicode_Check

Definition at line 1199 of file pytypes.h.

Typedef Documentation

◆ dict_iterator

using dict_iterator = generic_iterator<iterator_policies::dict_readonly>

Definition at line 1178 of file pytypes.h.

◆ is_ds_unpacking

template<typename T >

using is_ds_unpacking = std::is_same<kwargs_proxy, T>

Definition at line 1221 of file pytypes.h.

◆ is_keyword

template<typename T >

using is_keyword = std::is_base_of<arg, T>

Python argument categories (using PEP 448 terms)

Definition at line 1217 of file pytypes.h.

◆ is_keyword_or_ds

template<typename T >

using is_keyword_or_ds = satisfies_any_of<T, is_keyword, is_ds_unpacking>

Definition at line 1225 of file pytypes.h.

◆ is_positional

template<typename T >

using is_positional = satisfies_none_of<T, is_keyword, is_s_unpacking, is_ds_unpacking>

Definition at line 1223 of file pytypes.h.

◆ is_pyobj_ptr_or_nullptr_t

template<typename T >

using is_pyobj_ptr_or_nullptr_t = detail::any_of<std::is_same<T, PyObject *>, std::is_same<T, PyObject *const>, std::is_same<T, std::nullptr_t> >

Definition at line 196 of file pytypes.h.

◆ is_pyobject

template<typename T >

using is_pyobject = std::is_base_of<pyobject_tag, remove_reference_t<T> >

Definition at line 70 of file pytypes.h.

◆ is_s_unpacking

template<typename T >

using is_s_unpacking = std::is_same<args_proxy, T>

Definition at line 1219 of file pytypes.h.

◆ item_accessor

using item_accessor = accessor<accessor_policies::generic_item>

Definition at line 62 of file pytypes.h.

◆ list_accessor

using list_accessor = accessor<accessor_policies::list_item>

Definition at line 64 of file pytypes.h.

◆ list_iterator

using list_iterator = generic_iterator<iterator_policies::sequence_fast_readonly>

Definition at line 1171 of file pytypes.h.

◆ obj_attr_accessor

using obj_attr_accessor = accessor<accessor_policies::obj_attr>

Definition at line 60 of file pytypes.h.

◆ sequence_accessor

using sequence_accessor = accessor<accessor_policies::sequence_item>

Definition at line 63 of file pytypes.h.

◆ sequence_iterator

using sequence_iterator = generic_iterator<iterator_policies::sequence_slow_readwrite>

Definition at line 1177 of file pytypes.h.

◆ str_attr_accessor

using str_attr_accessor = accessor<accessor_policies::str_attr>

Definition at line 61 of file pytypes.h.

◆ tuple_accessor

using tuple_accessor = accessor<accessor_policies::tuple_item>

Definition at line 65 of file pytypes.h.

◆ tuple_iterator

using tuple_iterator = generic_iterator<iterator_policies::sequence_fast_readonly>

Definition at line 1170 of file pytypes.h.

Function Documentation

◆ dict_getitem()

PyObject* dict_getitem	(	PyObject *	v,
		PyObject *	key
	)

inline

Definition at line 833 of file pytypes.h.

◆ dict_getitemstring()

PyObject* dict_getitemstring	(	PyObject *	v,
		const char *	key
	)

inline

Definition at line 818 of file pytypes.h.

◆ error_string()

std::string error_string ( )

inline

Definition at line 578 of file pytypes.h.

◆ get_function()

handle get_function ( handle value )

inline

Definition at line 803 of file pytypes.h.

◆ isinstance< handle >()

template<>

bool isinstance< handle > ( handle )

inlinedelete

◆ isinstance< object >()

template<>

bool isinstance< object > ( handle obj )

inline

Definition at line 712 of file pytypes.h.

◆ isinstance_generic()

bool isinstance_generic	(	handle	obj,
		const std::type_info &	tp
	)

Definition at line 465 of file type_caster_base.h.

◆ obj_class_name()

const char* obj_class_name ( PyObject * obj )

inline

Definition at line 415 of file pytypes.h.

◆ object_or_cast() [1/3]

template<typename T , enable_if_t< is_pyobject< T >::value, int > = 0>

auto object_or_cast ( T && o ) -> decltype(std::forward<T>(o))

Definition at line 845 of file pytypes.h.

◆ object_or_cast() [2/3]

template<typename T , enable_if_t<!is_pyobject< T >::value, int > = 0>

object object_or_cast ( T && o )

Definition at line 1149 of file cast.h.

◆ object_or_cast() [3/3]

handle object_or_cast ( PyObject * ptr )

inline

Definition at line 852 of file pytypes.h.

◆ PyEllipsis_Check()

bool PyEllipsis_Check ( PyObject * o )

inline

Definition at line 1191 of file pytypes.h.

◆ PyIterable_Check()

bool PyIterable_Check ( PyObject * obj )

inline

Definition at line 1180 of file pytypes.h.

◆ PyNone_Check()

bool PyNone_Check ( PyObject * o )

inline

Definition at line 1190 of file pytypes.h.

◆ PyStaticMethod_Check()

bool PyStaticMethod_Check ( PyObject * o )

inline

Definition at line 1202 of file pytypes.h.

◆ raise_from() [1/2]

void raise_from	(	PyObject *	type,
		const char *	message
	)

inline

Replaces the current Python error indicator with the chosen error, performing a 'raise from' to indicate that the chosen error was caused by the original error.

Definition at line 655 of file pytypes.h.

◆ raise_from() [2/2]

void raise_from	(	error_already_set &	err,
		PyObject *	type,
		const char *	message
	)

inline

Sets the current Python error indicator with the chosen error, performing a 'raise from' from the error contained in error_already_set to indicate that the chosen error was caused by the original error.

Definition at line 684 of file pytypes.h.

◆ reinterpret_borrow()

template<typename T >

T reinterpret_borrow ( handle h )

Declare that a handle or PyObject * is a certain type and borrow the reference. The target type T must be object or one of its derived classes. The function doesn't do any conversions or checks. It's up to the user to make sure that the target type is correct.

.. code-block:: cpp

PyObject *p = PyList_GetItem(obj, index);
py::object o = reinterpret_borrow<py::object>(p);

or py::tuple t = reinterpret_borrow<py::tuple>(p); // <– p must be already be a tuple

Definition at line 395 of file pytypes.h.

◆ reinterpret_steal()

template<typename T >

T reinterpret_steal ( handle h )

Like reinterpret_borrow, but steals the reference.

.. code-block:: cpp

PyObject *p = PyObject_Str(obj); py::str s = reinterpret_steal<py::str>(p); // <– p must be already be a str

Definition at line 408 of file pytypes.h.

Classes

Namespaces

Macros

Typedefs

Functions

Macro Definition Documentation

◆ PYBIND11_HANDLE_REF_DEBUG

◆ PYBIND11_MATH_OPERATOR_BINARY

◆ PYBIND11_MATH_OPERATOR_UNARY

◆ PYBIND11_OBJECT

◆ PYBIND11_OBJECT_CHECK_FAILED

◆ PYBIND11_OBJECT_COMMON

◆ PYBIND11_OBJECT_CVT

◆ PYBIND11_OBJECT_CVT_DEFAULT

◆ PYBIND11_OBJECT_DEFAULT

◆ PYBIND11_STR_CHECK_FUN

Typedef Documentation

◆ dict_iterator

◆ is_ds_unpacking

◆ is_keyword

◆ is_keyword_or_ds

◆ is_positional

◆ is_pyobj_ptr_or_nullptr_t

◆ is_pyobject

◆ is_s_unpacking

◆ item_accessor

◆ list_accessor

◆ list_iterator

◆ obj_attr_accessor

◆ sequence_accessor

◆ sequence_iterator

◆ str_attr_accessor

◆ tuple_accessor

◆ tuple_iterator

Function Documentation

◆ dict_getitem()

◆ dict_getitemstring()

◆ error_string()

◆ get_function()

◆ isinstance< handle >()

◆ isinstance< object >()

◆ isinstance_generic()

◆ obj_class_name()

◆ object_or_cast() [1/3]

◆ object_or_cast() [2/3]

◆ object_or_cast() [3/3]

◆ PyEllipsis_Check()

◆ PyIterable_Check()

◆ PyNone_Check()

◆ PyStaticMethod_Check()

◆ raise_from() [1/2]

◆ raise_from() [2/2]

◆ reinterpret_borrow()

◆ reinterpret_steal()