Objects for Type Hinting¶
Various built-in types for type hinting are provided. Currently,
two types exist -- GenericAlias and
Union. Only GenericAlias
is exposed to C.
-
PyObject *Py_GenericAlias(PyObject *origin, PyObject *args)¶
- Part of the Stable ABI since version 3.9.
Create a GenericAlias object. Equivalent to calling the Python class
types.GenericAlias
. The origin and args arguments set theGenericAlias
's__origin__
and__args__
attributes respectively. origin should be a PyTypeObject*, and args can be a PyTupleObject* or anyPyObject*
. If args passed is not a tuple, a 1-tuple is automatically constructed and__args__
is set to(args,)
. Minimal checking is done for the arguments, so the function will succeed even if origin is not a type. TheGenericAlias
's__parameters__
attribute is constructed lazily from__args__
. On failure, an exception is raised andNULL
is returned.Here's an example of how to make an extension type generic:
... static PyMethodDef my_obj_methods[] = { // Other methods. ... {"__class_getitem__", Py_GenericAlias, METH_O|METH_CLASS, "See PEP 585"} ... }
Voir aussi
The data model method
__class_getitem__()
.Ajouté dans la version 3.9.
-
PyTypeObject Py_GenericAliasType¶
- Part of the Stable ABI since version 3.9.
The C type of the object returned by
Py_GenericAlias()
. Equivalent totypes.GenericAlias
in Python.Ajouté dans la version 3.9.