Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 1 | .. highlightlang:: c |
| 2 | |
| 3 | .. _typeobjects: |
| 4 | |
| 5 | Type Objects |
| 6 | ------------ |
| 7 | |
| 8 | .. index:: object: type |
| 9 | |
| 10 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 11 | .. c:type:: PyTypeObject |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 12 | |
| 13 | The C structure of the objects used to describe built-in types. |
| 14 | |
| 15 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 16 | .. c:var:: PyObject* PyType_Type |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 17 | |
| 18 | .. index:: single: TypeType (in module types) |
| 19 | |
| 20 | This is the type object for type objects; it is the same object as ``type`` and |
| 21 | ``types.TypeType`` in the Python layer. |
| 22 | |
| 23 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 24 | .. c:function:: int PyType_Check(PyObject *o) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 25 | |
| 26 | Return true if the object *o* is a type object, including instances of types |
| 27 | derived from the standard type object. Return false in all other cases. |
| 28 | |
| 29 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 30 | .. c:function:: int PyType_CheckExact(PyObject *o) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 31 | |
| 32 | Return true if the object *o* is a type object, but not a subtype of the |
| 33 | standard type object. Return false in all other cases. |
| 34 | |
| 35 | .. versionadded:: 2.2 |
| 36 | |
| 37 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 38 | .. c:function:: unsigned int PyType_ClearCache() |
Christian Heimes | 908caac | 2008-01-27 23:34:59 +0000 | [diff] [blame] | 39 | |
Georg Brandl | 74a1dea | 2008-05-28 11:21:39 +0000 | [diff] [blame] | 40 | Clear the internal lookup cache. Return the current version tag. |
| 41 | |
| 42 | .. versionadded:: 2.6 |
| 43 | |
| 44 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 45 | .. c:function:: void PyType_Modified(PyTypeObject *type) |
Georg Brandl | 74a1dea | 2008-05-28 11:21:39 +0000 | [diff] [blame] | 46 | |
| 47 | Invalidate the internal lookup cache for the type and all of its |
| 48 | subtypes. This function must be called after any manual |
| 49 | modification of the attributes or base classes of the type. |
Christian Heimes | 908caac | 2008-01-27 23:34:59 +0000 | [diff] [blame] | 50 | |
| 51 | .. versionadded:: 2.6 |
| 52 | |
| 53 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 54 | .. c:function:: int PyType_HasFeature(PyObject *o, int feature) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 55 | |
| 56 | Return true if the type object *o* sets the feature *feature*. Type features |
| 57 | are denoted by single bit flags. |
| 58 | |
| 59 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 60 | .. c:function:: int PyType_IS_GC(PyObject *o) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 61 | |
| 62 | Return true if the type object includes support for the cycle detector; this |
| 63 | tests the type flag :const:`Py_TPFLAGS_HAVE_GC`. |
| 64 | |
| 65 | .. versionadded:: 2.0 |
| 66 | |
| 67 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 68 | .. c:function:: int PyType_IsSubtype(PyTypeObject *a, PyTypeObject *b) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 69 | |
| 70 | Return true if *a* is a subtype of *b*. |
| 71 | |
| 72 | .. versionadded:: 2.2 |
| 73 | |
Georg Brandl | b74cf54 | 2014-10-06 14:15:06 +0200 | [diff] [blame] | 74 | This function only checks for actual subtypes, which means that |
Georg Brandl | 8b14dd3 | 2014-10-06 16:21:08 +0200 | [diff] [blame] | 75 | :meth:`~class.__subclasscheck__` is not called on *b*. Call |
Georg Brandl | b74cf54 | 2014-10-06 14:15:06 +0200 | [diff] [blame] | 76 | :c:func:`PyObject_IsSubclass` to do the same check that :func:`issubclass` |
| 77 | would do. |
| 78 | |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 79 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 80 | .. c:function:: PyObject* PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 81 | |
| 82 | .. versionadded:: 2.2 |
| 83 | |
Jeroen Ruigrok van der Werven | 089c5cd | 2009-04-25 17:59:03 +0000 | [diff] [blame] | 84 | .. versionchanged:: 2.5 |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 85 | This function used an :c:type:`int` type for *nitems*. This might require |
Jeroen Ruigrok van der Werven | 089c5cd | 2009-04-25 17:59:03 +0000 | [diff] [blame] | 86 | changes in your code for properly supporting 64-bit systems. |
| 87 | |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 88 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 89 | .. c:function:: PyObject* PyType_GenericNew(PyTypeObject *type, PyObject *args, PyObject *kwds) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 90 | |
| 91 | .. versionadded:: 2.2 |
| 92 | |
| 93 | |
Sandro Tosi | 98ed08f | 2012-01-14 16:42:02 +0100 | [diff] [blame] | 94 | .. c:function:: int PyType_Ready(PyTypeObject *type) |
Georg Brandl | f684272 | 2008-01-19 22:08:21 +0000 | [diff] [blame] | 95 | |
| 96 | Finalize a type object. This should be called on all type objects to finish |
| 97 | their initialization. This function is responsible for adding inherited slots |
| 98 | from a type's base class. Return ``0`` on success, or return ``-1`` and sets an |
| 99 | exception on error. |
| 100 | |
| 101 | .. versionadded:: 2.2 |