mirror of
https://github.com/python/cpython.git
synced 2024-12-03 06:46:01 +08:00
89e7cdcb9c
Issue #26564: * Expose _Py_DumpASCII() and _Py_DumpDecimal() in traceback.h * Change the type of the second _Py_DumpASCII() parameter from int to unsigned long * Rewrite _Py_DumpDecimal() and dump_hexadecimal() to write directly characters in the expected order, avoid the need of reversing the string. * dump_hexadecimal() limits width to the size of the buffer * _Py_DumpASCII() does nothing if the object is not a Unicode string * dump_frame() wrtites "???" as the line number if the line number is negative
92 lines
2.7 KiB
C
92 lines
2.7 KiB
C
|
|
#ifndef Py_TRACEBACK_H
|
|
#define Py_TRACEBACK_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "pystate.h"
|
|
|
|
struct _frame;
|
|
|
|
/* Traceback interface */
|
|
#ifndef Py_LIMITED_API
|
|
typedef struct _traceback {
|
|
PyObject_HEAD
|
|
struct _traceback *tb_next;
|
|
struct _frame *tb_frame;
|
|
int tb_lasti;
|
|
int tb_lineno;
|
|
} PyTracebackObject;
|
|
#endif
|
|
|
|
PyAPI_FUNC(int) PyTraceBack_Here(struct _frame *);
|
|
PyAPI_FUNC(int) PyTraceBack_Print(PyObject *, PyObject *);
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(int) _Py_DisplaySourceLine(PyObject *, PyObject *, int, int);
|
|
PyAPI_FUNC(void) _PyTraceback_Add(const char *, const char *, int);
|
|
#endif
|
|
|
|
/* Reveal traceback type so we can typecheck traceback objects */
|
|
PyAPI_DATA(PyTypeObject) PyTraceBack_Type;
|
|
#define PyTraceBack_Check(v) (Py_TYPE(v) == &PyTraceBack_Type)
|
|
|
|
/* Write the Python traceback into the file 'fd'. For example:
|
|
|
|
Traceback (most recent call first):
|
|
File "xxx", line xxx in <xxx>
|
|
File "xxx", line xxx in <xxx>
|
|
...
|
|
File "xxx", line xxx in <xxx>
|
|
|
|
This function is written for debug purpose only, to dump the traceback in
|
|
the worst case: after a segmentation fault, at fatal error, etc. That's why,
|
|
it is very limited. Strings are truncated to 100 characters and encoded to
|
|
ASCII with backslashreplace. It doesn't write the source code, only the
|
|
function name, filename and line number of each frame. Write only the first
|
|
100 frames: if the traceback is truncated, write the line " ...".
|
|
|
|
This function is signal safe. */
|
|
|
|
PyAPI_DATA(void) _Py_DumpTraceback(
|
|
int fd,
|
|
PyThreadState *tstate);
|
|
|
|
/* Write the traceback of all threads into the file 'fd'. current_thread can be
|
|
NULL. Return NULL on success, or an error message on error.
|
|
|
|
This function is written for debug purpose only. It calls
|
|
_Py_DumpTraceback() for each thread, and so has the same limitations. It
|
|
only write the traceback of the first 100 threads: write "..." if there are
|
|
more threads.
|
|
|
|
This function is signal safe. */
|
|
|
|
PyAPI_DATA(const char*) _Py_DumpTracebackThreads(
|
|
int fd, PyInterpreterState *interp,
|
|
PyThreadState *current_thread);
|
|
|
|
|
|
#ifndef Py_LIMITED_API
|
|
|
|
/* Write a Unicode object into the file descriptor fd. Encode the string to
|
|
ASCII using the backslashreplace error handler.
|
|
|
|
Do nothing if text is not a Unicode object. The function accepts Unicode
|
|
string which is not ready (PyUnicode_WCHAR_KIND).
|
|
|
|
This function is signal safe. */
|
|
PyAPI_FUNC(void) _Py_DumpASCII(int fd, PyObject *text);
|
|
|
|
/* Format an integer as decimal into the file descriptor fd.
|
|
|
|
This function is signal safe. */
|
|
PyAPI_FUNC(void) _Py_DumpDecimal(int fd, unsigned long value);
|
|
|
|
#endif /* !Py_LIMITED_API */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_TRACEBACK_H */
|