Objetos frame

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

La estructura C de los objetos utilizados para describir los objetos del frame.

No hay miembros públicos en esta estructura.

Distinto en la versión 3.11: Los miembros de esta estructura se han eliminado de la API pública de C. Consulte la entrada Novedades para más detalles.

Las funciones PyEval_GetFrame() y PyThreadState_GetFrame() pueden utilizarse para obtener un objeto frame.

Véase también Reflexión.

PyTypeObject PyFrame_Type

The type of frame objects. It is the same object as types.FrameType in the Python layer.

Distinto en la versión 3.11: Previously, this type was only available after including <frameobject.h>.

int PyFrame_Check(PyObject *obj)

Return non-zero if obj is a frame object.

Distinto en la versión 3.11: Previously, this function was only available after including <frameobject.h>.

PyFrameObject *PyFrame_GetBack(PyFrameObject *frame)
Return value: New reference.

Obtiene el frame exterior siguiente.

Retorna una strong reference, o NULL si frame no tiene frame exterior.

Added in version 3.9.

PyObject *PyFrame_GetBuiltins(PyFrameObject *frame)
Return value: New reference.

Get the frame’s f_builtins attribute.

Retorna una strong reference, o NULL si frame no tiene frame exterior.

Added in version 3.11.

PyCodeObject *PyFrame_GetCode(PyFrameObject *frame)
Return value: New reference. Part of the Stable ABI since version 3.10.

Obtenga el código frame.

Retorna un strong reference.

El resultado (frame code) no puede ser NULL.

Added in version 3.9.

PyObject *PyFrame_GetGenerator(PyFrameObject *frame)
Return value: New reference.

Obtiene el generador, rutina o generador asíncrono al que pertenece este frame, o NULL si este frame no es propiedad de un generador. No lanza una excepción, incluso si el valor de retorno es NULL.

Retorna un strong reference, o NULL.

Added in version 3.11.

PyObject *PyFrame_GetGlobals(PyFrameObject *frame)
Return value: New reference.

Get the frame’s f_globals attribute.

Retorna una strong reference, o NULL si frame no tiene frame exterior.

Added in version 3.11.

int PyFrame_GetLasti(PyFrameObject *frame)

Get the frame’s f_lasti attribute.

Retorna -1 si frame.f_lasti es None.

Added in version 3.11.

PyObject *PyFrame_GetVar(PyFrameObject *frame, PyObject *name)
Return value: New reference.

Get the variable name of frame.

  • Return a strong reference to the variable value on success.

  • Raise NameError and return NULL if the variable does not exist.

  • Raise an exception and return NULL on error.

name type must be a str.

Added in version 3.12.

PyObject *PyFrame_GetVarString(PyFrameObject *frame, const char *name)
Return value: New reference.

Similar to PyFrame_GetVar(), but the variable name is a C string encoded in UTF-8.

Added in version 3.12.

PyObject *PyFrame_GetLocals(PyFrameObject *frame)
Return value: New reference.

Get the frame’s f_locals attribute. If the frame refers to an optimized scope, this returns a write-through proxy object that allows modifying the locals. In all other cases (classes, modules, exec(), eval()) it returns the mapping representing the frame locals directly (as described for locals()).

Retorna un strong reference.

Added in version 3.11.

Distinto en la versión 3.13: As part of PEP 667, return an instance of PyFrameLocalsProxy_Type.

int PyFrame_GetLineNumber(PyFrameObject *frame)
Part of the Stable ABI since version 3.10.

Retorna el número de línea en la que se está ejecutando el frame.

Frame Locals Proxies

Added in version 3.13.

The f_locals attribute on a frame object is an instance of a «frame-locals proxy». The proxy object exposes a write-through view of the underlying locals dictionary for the frame. This ensures that the variables exposed by f_locals are always up to date with the live local variables in the frame itself.

See PEP 667 for more information.

PyTypeObject PyFrameLocalsProxy_Type

The type of frame locals() proxy objects.

int PyFrameLocalsProxy_Check(PyObject *obj)

Return non-zero if obj is a frame locals() proxy.

Internal Frames

Unless using PEP 523, you will not need this.

struct _PyInterpreterFrame

The interpreter’s internal frame representation.

Added in version 3.11.

PyObject *PyUnstable_InterpreterFrame_GetCode(struct _PyInterpreterFrame *frame);
This is Unstable API. It may change without warning in minor releases.

Return a strong reference to the code object for the frame.

Added in version 3.12.

int PyUnstable_InterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);
This is Unstable API. It may change without warning in minor releases.

Return the byte offset into the last executed instruction.

Added in version 3.12.

int PyUnstable_InterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);
This is Unstable API. It may change without warning in minor releases.

Return the currently executing line number, or -1 if there is no line number.

Added in version 3.12.