mirror of
https://github.com/python/cpython.git
synced 2025-07-29 22:24:49 +00:00
f7f858d141
Most uses of PyCode_Addr2Line (http://www.google.com/codesearch?q=PyCode_Addr2Line) are just trying to get the line number of a specified frame, but there's no way to do that directly. Forcing people to go through the code object makes them know more about the guts of the interpreter than they should need. The remaining uses of PyCode_Addr2Line seem to be getting the line from a traceback (for example, http://www.google.com/codesearch/p?hl=en#u_9_nDrchrw/pygame-1.7.1release/src/base.c&q=PyCode_Addr2Line), which is replaced by the tb_lineno field. So we may be able to deprecate PyCode_Addr2Line entirely for external use.
89 lines
3.1 KiB
C
89 lines
3.1 KiB
C
|
|
/* Frame object interface */
|
|
|
|
#ifndef Py_FRAMEOBJECT_H
|
|
#define Py_FRAMEOBJECT_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct {
|
|
int b_type; /* what kind of block this is */
|
|
int b_handler; /* where to jump to find handler */
|
|
int b_level; /* value stack level to pop to */
|
|
} PyTryBlock;
|
|
|
|
typedef struct _frame {
|
|
PyObject_VAR_HEAD
|
|
struct _frame *f_back; /* previous frame, or NULL */
|
|
PyCodeObject *f_code; /* code segment */
|
|
PyObject *f_builtins; /* builtin symbol table (PyDictObject) */
|
|
PyObject *f_globals; /* global symbol table (PyDictObject) */
|
|
PyObject *f_locals; /* local symbol table (any mapping) */
|
|
PyObject **f_valuestack; /* points after the last local */
|
|
/* Next free slot in f_valuestack. Frame creation sets to f_valuestack.
|
|
Frame evaluation usually NULLs it, but a frame that yields sets it
|
|
to the current stack top. */
|
|
PyObject **f_stacktop;
|
|
PyObject *f_trace; /* Trace function */
|
|
|
|
/* If an exception is raised in this frame, the next three are used to
|
|
* record the exception info (if any) originally in the thread state. See
|
|
* comments before set_exc_info() -- it's not obvious.
|
|
* Invariant: if _type is NULL, then so are _value and _traceback.
|
|
* Desired invariant: all three are NULL, or all three are non-NULL. That
|
|
* one isn't currently true, but "should be".
|
|
*/
|
|
PyObject *f_exc_type, *f_exc_value, *f_exc_traceback;
|
|
|
|
PyThreadState *f_tstate;
|
|
int f_lasti; /* Last instruction if called */
|
|
/* Call PyFrame_GetLineNumber() instead of reading this field
|
|
directly. As of 2.3 f_lineno is only valid when tracing is
|
|
active (i.e. when f_trace is set). At other times we use
|
|
PyCode_Addr2Line to calculate the line from the current
|
|
bytecode index. */
|
|
int f_lineno; /* Current line number */
|
|
int f_iblock; /* index in f_blockstack */
|
|
PyTryBlock f_blockstack[CO_MAXBLOCKS]; /* for try and loop blocks */
|
|
PyObject *f_localsplus[1]; /* locals+stack, dynamically sized */
|
|
} PyFrameObject;
|
|
|
|
|
|
/* Standard object interface */
|
|
|
|
PyAPI_DATA(PyTypeObject) PyFrame_Type;
|
|
|
|
#define PyFrame_Check(op) ((op)->ob_type == &PyFrame_Type)
|
|
#define PyFrame_IsRestricted(f) \
|
|
((f)->f_builtins != (f)->f_tstate->interp->builtins)
|
|
|
|
PyAPI_FUNC(PyFrameObject *) PyFrame_New(PyThreadState *, PyCodeObject *,
|
|
PyObject *, PyObject *);
|
|
|
|
|
|
/* The rest of the interface is specific for frame objects */
|
|
|
|
/* Block management functions */
|
|
|
|
PyAPI_FUNC(void) PyFrame_BlockSetup(PyFrameObject *, int, int, int);
|
|
PyAPI_FUNC(PyTryBlock *) PyFrame_BlockPop(PyFrameObject *);
|
|
|
|
/* Extend the value stack */
|
|
|
|
PyAPI_FUNC(PyObject **) PyFrame_ExtendStack(PyFrameObject *, int, int);
|
|
|
|
/* Conversions between "fast locals" and locals in dictionary */
|
|
|
|
PyAPI_FUNC(void) PyFrame_LocalsToFast(PyFrameObject *, int);
|
|
PyAPI_FUNC(void) PyFrame_FastToLocals(PyFrameObject *);
|
|
|
|
PyAPI_FUNC(int) PyFrame_ClearFreeList(void);
|
|
|
|
/* Return the line of code the frame is currently executing. */
|
|
PyAPI_FUNC(int) PyFrame_GetLineNumber(PyFrameObject *);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_FRAMEOBJECT_H */
|