Type Objects¶
PyTypeObject
¶The C structure of the objects used to describe built-in types.
- PyObject*
PyType_Type
¶ This is the type object for type objects; it is the same object as
type
in the Python layer.
- int
PyType_Check
(PyObject *o)¶ Return true if the objecto is a type object, including instances of typesderived from the standard type object. Return false in all other cases.
- int
PyType_CheckExact
(PyObject *o)¶ Return true if the objecto is a type object, but not a subtype of thestandard type object. Return false in all other cases.
- unsigned int
PyType_ClearCache
()¶ Clear the internal lookup cache. Return the current version tag.
- long
PyType_GetFlags
(PyTypeObject* type)¶ Return the
tp_flags
member oftype. This function is primarilymeant for use withPy_LIMITED_API; the individual flag bits areguaranteed to be stable across Python releases, but access totp_flags
itself is not part of the limited API.New in version 3.2.
- void
PyType_Modified
(PyTypeObject *type)¶ Invalidate the internal lookup cache for the type and all of itssubtypes. This function must be called after any manualmodification of the attributes or base classes of the type.
- int
PyType_HasFeature
(PyTypeObject *o, int feature)¶ Return true if the type objecto sets the featurefeature. Type featuresare denoted by single bit flags.
- int
PyType_IS_GC
(PyTypeObject *o)¶ Return true if the type object includes support for the cycle detector; thistests the type flag
Py_TPFLAGS_HAVE_GC
.
- int
PyType_IsSubtype
(PyTypeObject *a,PyTypeObject *b)¶ Return true ifa is a subtype ofb.
This function only checks for actual subtypes, which means that
__subclasscheck__()
is not called onb. CallPyObject_IsSubclass()
to do the same check thatissubclass()
would do.
- PyObject*
PyType_GenericAlloc
(PyTypeObject *type, Py_ssize_t nitems)¶ - Return value: New reference.
Generic handler for the
tp_alloc
slot of a type object. UsePython’s default memory allocation mechanism to allocate a new instance andinitialize all its contents toNULL.
- PyObject*
PyType_GenericNew
(PyTypeObject *type,PyObject *args,PyObject *kwds)¶ - Return value: New reference.
Generic handler for the
tp_new
slot of a type object. Create anew instance using the type’stp_alloc
slot.
- int
PyType_Ready
(PyTypeObject *type)¶ Finalize a type object. This should be called on all type objects to finishtheir initialization. This function is responsible for adding inherited slotsfrom a type’s base class. Return
0
on success, or return-1
and sets anexception on error.
- PyObject*
PyType_FromSpec
(PyType_Spec *spec)¶ Creates and returns a heap type object from thespec passed to the function.
- PyObject*
PyType_FromSpecWithBases
(PyType_Spec *spec,PyObject *bases)¶ Creates and returns a heap type object from thespec. In addition to that,the created heap type contains all types contained by thebases tuple as basetypes. This allows the caller to reference other heap types as base types.
New in version 3.3.
- void*
PyType_GetSlot
(PyTypeObject *type, int slot)¶ Return the function pointer stored in the given slot. If theresult isNULL, this indicates that either the slot isNULL,or that the function was called with invalid parameters.Callers will typically cast the result pointer into the appropriatefunction type.
New in version 3.4.