mirror of
https://github.com/python/cpython.git
synced 2026-01-02 21:43:49 +00:00
46 lines
1.8 KiB
C
46 lines
1.8 KiB
C
/* Frame object interface */
|
|
|
|
#ifndef Py_CPYTHON_FRAMEOBJECT_H
|
|
# error "this header file must not be included directly"
|
|
#endif
|
|
|
|
struct _PyInterpreterFrame;
|
|
|
|
/* Standard object interface */
|
|
|
|
PyAPI_FUNC(PyFrameObject *) PyFrame_New(PyThreadState *, PyCodeObject *,
|
|
PyObject *, PyObject *);
|
|
|
|
/* The rest of the interface is specific for frame objects */
|
|
|
|
/* Conversions between "fast locals" and locals in dictionary */
|
|
|
|
PyAPI_FUNC(void) PyFrame_LocalsToFast(PyFrameObject *, int);
|
|
|
|
/* -- Caveat emptor --
|
|
* The concept of entry frames is an implementation detail of the CPython
|
|
* interpreter. This API is considered unstable and is provided for the
|
|
* convenience of debuggers, profilers and state-inspecting tools. Notice that
|
|
* this API can be changed in future minor versions if the underlying frame
|
|
* mechanism change or the concept of an 'entry frame' or its semantics becomes
|
|
* obsolete or outdated. */
|
|
|
|
PyAPI_FUNC(int) _PyFrame_IsEntryFrame(PyFrameObject *frame);
|
|
|
|
PyAPI_FUNC(int) PyFrame_FastToLocalsWithError(PyFrameObject *f);
|
|
PyAPI_FUNC(void) PyFrame_FastToLocals(PyFrameObject *);
|
|
|
|
/* The following functions are for use by debuggers and other tools
|
|
* implementing custom frame evaluators with PEP 523. */
|
|
|
|
/* Returns the code object of the frame (strong reference).
|
|
* Does not raise an exception. */
|
|
PyAPI_FUNC(PyCodeObject *) PyUnstable_InterpreterFrame_GetCode(struct _PyInterpreterFrame *frame);
|
|
|
|
/* Returns a byte ofsset into the last executed instruction.
|
|
* Does not raise an exception. */
|
|
PyAPI_FUNC(int) PyUnstable_InterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);
|
|
|
|
/* Returns the currently executing line number, or -1 if there is no line number.
|
|
* Does not raise an exception. */
|
|
PyAPI_FUNC(int) PyUnstable_InterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);
|