# Objetos Tipos

type `PyTypeObject`
  Part of the Limited API (as an opaque struct).

  La estructura C de los objetos utilizados para describir los tipos incorporados.

PyTypeObject `PyType_Type`
  Part of the Stable ABI.

  Este es el objeto tipo para objetos tipo; es el mismo objeto que `type` en la capa Python.

int `PyType_Check`(PyObject *o)

  Retorna un valor distinto de cero si el objeto o es un objeto tipo, incluidas las instancias de tipos derivados del objeto de tipo estándar. Retorna 0 en todos los demás casos. Esta función siempre finaliza con éxito.

int `PyType_CheckExact`(PyObject *o)

  Retorna un valor distinto de cero si el objeto o es un objeto tipo, pero no un subtipo del objeto tipo estándar. Retorna 0 en todos los demás casos. Esta función siempre finaliza con éxito.

unsigned int `PyType_ClearCache`()
  Part of the Stable ABI.

  Borra la caché de búsqueda interna. Retorna la etiqueta (tag) de la versión actual.

unsigned long `PyType_GetFlags`(PyTypeObject *type)
  Part of the Stable ABI.

  Return the `tp_flags` member of type. This function is primarily meant for use with `Py_LIMITED_API`; the individual flag bits are guaranteed to be stable across Python releases, but access to `tp_flags` itself is not part of the limited API.

  Nuevo en la versión 3.2.

  Distinto en la versión 3.4: El tipo de retorno es ahora `unsigned long` en vez de `long`.

void `PyType_Modified`(PyTypeObject *type)
  Part of the Stable ABI.

  Invalida la memoria caché de búsqueda interna para el tipo y todos sus subtipos. Esta función debe llamarse después de cualquier modificación manual de los atributos o clases base del tipo.

int `PyType_HasFeature`(PyTypeObject *o, int feature)

  Retorna un valor distinto de cero si el tipo objeto o establece la característica feature. Las características de tipo se indican mediante flags de un solo bit.

int `PyType_IS_GC`(PyTypeObject *o)

  Retorna verdadero si el objeto tipo incluye soporte para el detector de ciclo; Esto prueba el indicador de tipo `Py_TPFLAGS_HAVE_GC`.

int `PyType_IsSubtype`(PyTypeObject *a, PyTypeObject *b)
  Part of the Stable ABI.

  Retorna verdadero si a es un subtipo de b.

  Esta función solo busca subtipos reales, lo que significa que `__subclasscheck__()` no se llama en b. Llama `PyObject_IsSubclass()` para hacer el mismo chequeo que `issubclass()` haría.

PyObject *`PyType_GenericAlloc`(PyTypeObject *type, Py_ssize_t nitems)
  Return value: New reference. Part of the Stable ABI.

  Controlador genérico para la ranura `tp_alloc` de un objeto tipo. Usa el mecanismo de asignación de memoria predeterminado de Python para asignar una nueva instancia e inicializar todo su contenido a `NULL`.

PyObject *`PyType_GenericNew`(PyTypeObject *type, PyObject *args, PyObject *kwds)
  Return value: New reference. Part of the Stable ABI.

  Controlador genérico para la ranura `tp_new` de un objeto tipo. Crea una nueva instancia utilizando la ranura del tipo `tp_alloc`.

int `PyType_Ready`(PyTypeObject *type)
  Part of the Stable ABI.

  Finalizar un objeto tipo. Se debe llamar a todos los objetos tipo para finalizar su inicialización. Esta función es responsable de agregar ranuras heredadas de la clase base de un tipo. Retorna `0` en caso de éxito o retorna `-1` y establece una excepción en caso de error.

  Nota

  Si algunas de las clases base implementan el protocolo GC y el tipo proporcionado no incluye el `Py_TPFLAGS_HAVE_GC` en sus banderas, entonces el protocolo GC se implementará automáticamente desde sus padres. Por el contrario, si el tipo que se está creando incluye `Py_TPFLAGS_HAVE_GC` en sus banderas, entonces debe implementar el protocolo GC por sí mismo al implementar al menos el identificador `tp_traverse`.

void *`PyType_GetSlot`(PyTypeObject *type, int slot)
  Part of the Stable ABI since version 3.4.

  Retorna el puntero de función almacenado en la ranura dada. Si el resultado es `NULL`, esto indica que la ranura es `NULL` o que la función se llamó con parámetros no válidos. Las personas que llaman suelen convertir el puntero de resultado en el tipo de función apropiado.

  Consulte `PyType_Slot.slot` para conocer los posibles valores del argumento slot.

  Nuevo en la versión 3.4.

  Distinto en la versión 3.10: `PyType_GetSlot()` ahora puede aceptar todos los tipos. Anteriormente, estaba limitado a heap types.

PyObject *`PyType_GetModule`(PyTypeObject *type)
  Part of the Stable ABI since version 3.10.

  Retorna el objeto módulo asociado con el tipo dado cuando se creó el tipo usando `PyType_FromModuleAndSpec()`.

  Si no hay ningún módulo asociado con el tipo dado, establece `TypeError` y retorna `NULL`.

  Esta función se suele utilizar para obtener el módulo en el que se define un método. Tenga en cuenta que en un método de este tipo, es posible que `PyType_GetModule(Py_TYPE(self))` no retorne el resultado deseado. `Py_TYPE(self)` puede ser una subclass de la clase deseada, y las subclases no están necesariamente definidas en el mismo módulo que su superclase. Consulte `PyCMethod` para obtener la clase que define el método.

  Nuevo en la versión 3.9.

void *`PyType_GetModuleState`(PyTypeObject *type)
  Part of the Stable ABI since version 3.10.

  Retorna el estado del objeto de módulo asociado con el tipo dado. Este es un atajo para llamar `PyModule_GetState()` en el resultado de `PyType_GetModule()`.

  Si no hay ningún módulo asociado con el tipo dado, establece `TypeError` y retorna `NULL`.

  Si el tipo type tiene un módulo asociado pero su estado es `NULL`, retorna `NULL` sin establecer una excepción.

  Nuevo en la versión 3.9.

## Crear tipos asignados en montículo (heap)

Las siguientes funciones y estructuras se utilizan para crear heap types.

PyObject *`PyType_FromModuleAndSpec`(PyObject *module, PyType_Spec *spec, PyObject *bases)
  Return value: New reference. Part of the Stable ABI since version 3.10.

  Crea y retorna un tipo heap a partir del spec (`Py_TPFLAGS_HEAPTYPE`).

  El argumento bases se puede utilizar para especificar clases base; puede ser solo una clase o una tupla de clases. Si bases es `NULL`, en su lugar se utiliza la ranura Py_tp_bases. Si esa también es `NULL`, se usa la ranura Py_tp_base en su lugar. Si también es `NULL`, el nuevo tipo se deriva de `object`.

  El argumento module se puede utilizar para registrar el módulo en el que se define la nueva clase. Debe ser un objeto de módulo o `NULL`. Si no es `NULL`, el módulo se asocia con el nuevo tipo y luego se puede recuperar con `PyType_GetModule()`. El módulo asociado no es heredado por subclases; debe especificarse para cada clase individualmente.

  Esta función llama `PyType_Ready()` en el tipo nuevo.

  Nuevo en la versión 3.9.

  Distinto en la versión 3.10: La función ahora acepta una sola clase como argumento bases y `NULL` como ranura `tp_doc`.

PyObject *`PyType_FromSpecWithBases`(PyType_Spec *spec, PyObject *bases)
  Return value: New reference. Part of the Stable ABI since version 3.3.

  Equivalente a `PyType_FromModuleAndSpec(NULL, spec, bases)`.

  Nuevo en la versión 3.3.

PyObject *`PyType_FromSpec`(PyType_Spec *spec)
  Return value: New reference. Part of the Stable ABI.

  Equivalente a `PyType_FromSpecWithBases(spec, NULL)`.

type `PyType_Spec`
  Part of the Stable ABI (including all members).

  Estructura que define el comportamiento de un tipo.

  const char *`PyType_Spec`.```name`

    Nombre del tipo, utilizado para establecer `PyTypeObject.tp_name`.

  int `PyType_Spec`.```basicsize`
  int `PyType_Spec`.```itemsize`

    Tamaño de la instancia en bytes, utilizado para establecer `PyTypeObject.tp_basicsize` y `PyTypeObject.tp_itemsize`.

  int `PyType_Spec`.```flags`

    Banderas (flags) del tipo, que se usan para establecer `PyTypeObject.tp_flags`.

    Si el indicador `Py_TPFLAGS_HEAPTYPE` no está establecido, `PyType_FromSpecWithBases()` lo establece automáticamente.

  PyType_Slot *`PyType_Spec`.```slots`

    Arreglo de estructuras `PyType_Slot`. Terminado por el valor de ranura especial `{0, NULL}`.

type `PyType_Slot`
  Part of the Stable ABI (including all members).

  Estructura que define la funcionalidad opcional de un tipo, que contiene una ranura ID y un puntero de valor.

  int `PyType_Slot`.```slot`

    > Una ranura ID.

    > Las ranuras IDs se nombran como los nombres de campo de las estructuras `PyTypeObject`, `PyNumberMethods`, `PySequenceMethods`, `PyMappingMethods` y `PyAsyncMethods` con un prefijo `Py_` agregado. Por ejemplo, use:

    > - `Py_tp_dealloc` para establecer `PyTypeObject.tp_dealloc`

    > - `Py_nb_add` para establecer `PyNumberMethods.nb_add`

    > - `Py_sq_length` para establecer `PySequenceMethods.sq_length`

    > Los siguientes campos no se pueden configurar en absoluto usando `PyType_Spec` y `PyType_Slot`:

    > - `tp_dict`

    > - `tp_mro`

    > - `tp_cache`

    > - `tp_subclasses`

    > - `tp_weaklist`

    > - `tp_vectorcall`

    > - `tp_weaklistoffset` (vea PyMemberDef)

    > - `tp_dictoffset` (vea PyMemberDef)

    > - `tp_vectorcall_offset` (vea PyMemberDef)

    > Los siguientes campos no se pueden establecer usando `PyType_Spec` y `PyType_Slot` cuando se utiliza la API limitada:

    > - `bf_getbuffer`

    > - `bf_releasebuffer`

    > Estableciendo `Py_tp_bases` o `Py_tp_base` puede ser problemático en algunas plataformas. Para evitar problemas, use el argumento bases de `PyType_FromSpecWithBases()` en su lugar.

    Distinto en la versión 3.9: Slots in `PyBufferProcs` may be set in the unlimited API.

  void *`PyType_Slot`.```pfunc`

    El valor deseado de la ranura. En la mayoría de los casos, este es un puntero a una función.

    Las ranuras que no sean `Py_tp_doc` pueden no ser `NULL`.