Type Objects¶

typePyTypeObject¶

Part of theLimited API (as an opaque struct).

The C structure of the objects used to describe built-in types.

PyTypeObjectPyType_Type¶

Part of theStable ABI.

This is the type object for type objects; it is the same object astype in the Python layer.

intPyType_Check(PyObject*o)¶

Return non-zero if the objecto is a type object, including instances oftypes derived from the standard type object. Return 0 in all other cases.This function always succeeds.

intPyType_CheckExact(PyObject*o)¶

Return non-zero if the objecto is a type object, but not a subtype ofthe standard type object. Return 0 in all other cases. This functionalways succeeds.

unsignedintPyType_ClearCache()¶

Part of theStable ABI.

Clear the internal lookup cache. Return the current version tag.

unsignedlongPyType_GetFlags(PyTypeObject*type)¶

Part of theStable ABI.

Return thetp_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 thelimited API.

New in version 3.2.

Changed in version 3.4:The return type is nowunsignedlong rather thanlong.

voidPyType_Modified(PyTypeObject*type)¶

Part of theStable ABI.

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.

intPyType_HasFeature(PyTypeObject*o,intfeature)¶

Return non-zero if the type objecto sets the featurefeature.Type features are denoted by single bit flags.

intPyType_IS_GC(PyTypeObject*o)¶

Return true if the type object includes support for the cycle detector; thistests the type flagPy_TPFLAGS_HAVE_GC.

intPyType_IsSubtype(PyTypeObject*a,PyTypeObject*b)¶

Part of theStable ABI.

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_tnitems)¶

Return value: New reference. Part of theStable ABI.

Generic handler for thetp_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. Part of theStable ABI.

Generic handler for thetp_new slot of a type object. Create anew instance using the type’stp_alloc slot.

intPyType_Ready(PyTypeObject*type)¶

Part of theStable ABI.

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. Return0 on success, or return-1 and sets anexception on error.

Note

If some of the base classes implements the GC protocol and the providedtype does not include thePy_TPFLAGS_HAVE_GC in its flags, thenthe GC protocol will be automatically implemented from its parents. Onthe contrary, if the type being created does includePy_TPFLAGS_HAVE_GC in its flags then itmust implement theGC protocol itself by at least implementing thetp_traverse handle.

PyObject*PyType_GetName(PyTypeObject*type)¶

Return value: New reference. Part of theStable ABI since version 3.11.

Return the type’s name. Equivalent to getting the type’s__name__ attribute.

New in version 3.11.

PyObject*PyType_GetQualName(PyTypeObject*type)¶

Return value: New reference. Part of theStable ABI since version 3.11.

Return the type’s qualified name. Equivalent to getting thetype’s__qualname__ attribute.

New in version 3.11.

void*PyType_GetSlot(PyTypeObject*type,intslot)¶

Part of theStable ABI since version 3.4.

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.

SeePyType_Slot.slot for possible values of theslot argument.

New in version 3.4.

Changed in version 3.10:PyType_GetSlot() can now accept all types.Previously, it was limited toheap types.

PyObject*PyType_GetModule(PyTypeObject*type)¶

Part of theStable ABI since version 3.10.

Return the module object associated with the given type when the type wascreated usingPyType_FromModuleAndSpec().

If no module is associated with the given type, setsTypeErrorand returnsNULL.

This function is usually used to get the module in which a method is defined.Note that in such a method,PyType_GetModule(Py_TYPE(self))may not return the intended result.Py_TYPE(self) may be asubclass of the intended class, and subclassesare not necessarily defined in the same module as their superclass.SeePyCMethod to get the class that defines the method.SeePyType_GetModuleByDef() for cases whenPyCMethod cannotbe used.

New in version 3.9.

void*PyType_GetModuleState(PyTypeObject*type)¶

Part of theStable ABI since version 3.10.

Return the state of the module object associated with the given type.This is a shortcut for callingPyModule_GetState() on the resultofPyType_GetModule().

If no module is associated with the given type, setsTypeErrorand returnsNULL.

If thetype has an associated module but its state isNULL,returnsNULL without setting an exception.

New in version 3.9.

PyObject*PyType_GetModuleByDef(PyTypeObject*type,structPyModuleDef*def)¶

Find the first superclass whose module was created fromthe givenPyModuleDefdef, and return that module.

If no module is found, raises aTypeError and returnsNULL.

This function is intended to be used together withPyModule_GetState() to get module state from slot methods (such astp_init ornb_add)and other places where a method’s defining class cannot be passed using thePyCMethod calling convention.

New in version 3.11.