1 #ifndef Py_ERRORS_H

     2 #define Py_ERRORS_H

     3 #ifdef __cplusplus

     4 extern "C" {

     5 #endif

     6 

     7 /* Error objects */

     8 

     9 typedef struct {

    10     PyObject_HEAD

    11     PyObject *dict;

    12     PyObject *args;

    13     PyObject *message;

    14 } PyBaseExceptionObject;

    15 

    16 typedef struct {

    17     PyObject_HEAD

    18     PyObject *dict;

    19     PyObject *args;

    20     PyObject *message;

    21     PyObject *msg;

    22     PyObject *filename;

    23     PyObject *lineno;

    24     PyObject *offset;

    25     PyObject *text;

    26     PyObject *print_file_and_line;

    27 } PySyntaxErrorObject;

    28 

    29 #ifdef Py_USING_UNICODE

    30 typedef struct {

    31     PyObject_HEAD

    32     PyObject *dict;

    33     PyObject *args;

    34     PyObject *message;

    35     PyObject *encoding;

    36     PyObject *object;

    37     Py_ssize_t start;

    38     Py_ssize_t end;

    39     PyObject *reason;

    40 } PyUnicodeErrorObject;

    41 #endif

    42 

    43 typedef struct {

    44     PyObject_HEAD

    45     PyObject *dict;

    46     PyObject *args;

    47     PyObject *message;

    48     PyObject *code;

    49 } PySystemExitObject;

    50 

    51 typedef struct {

    52     PyObject_HEAD

    53     PyObject *dict;

    54     PyObject *args;

    55     PyObject *message;

    56     PyObject *myerrno;

    57     PyObject *strerror;

    58     PyObject *filename;

    59 } PyEnvironmentErrorObject;

    60 

    61 #ifdef MS_WINDOWS

    62 typedef struct {

    63     PyObject_HEAD

    64     PyObject *dict;

    65     PyObject *args;

    66     PyObject *message;

    67     PyObject *myerrno;

    68     PyObject *strerror;

    69     PyObject *filename;

    70     PyObject *winerror;

    71 } PyWindowsErrorObject;

    72 #endif

    73 

    74 /* Error handling definitions */

    75 

    76 PyAPI_FUNC(void) PyErr_SetNone(PyObject *);

    77 PyAPI_FUNC(void) PyErr_SetObject(PyObject *, PyObject *);

    78 PyAPI_FUNC(void) PyErr_SetString(PyObject *, const char *);

    79 PyAPI_FUNC(PyObject *) PyErr_Occurred(void);

    80 PyAPI_FUNC(void) PyErr_Clear(void);

    81 PyAPI_FUNC(void) PyErr_Fetch(PyObject **, PyObject **, PyObject **);

    82 PyAPI_FUNC(void) PyErr_Restore(PyObject *, PyObject *, PyObject *);

    83 

    84 #ifdef Py_DEBUG

    85 #define _PyErr_OCCURRED() PyErr_Occurred()

    86 #else

    87 #define _PyErr_OCCURRED() (_PyThreadState_Current->curexc_type)

    88 #endif

    89 

    90 /* Error testing and normalization */

    91 PyAPI_FUNC(int) PyErr_GivenExceptionMatches(PyObject *, PyObject *);

    92 PyAPI_FUNC(int) PyErr_ExceptionMatches(PyObject *);

    93 PyAPI_FUNC(void) PyErr_NormalizeException(PyObject**, PyObject**, PyObject**);

    94 

    95 /* */

    96 

    97 #define PyExceptionClass_Check(x)					\

    98 	(PyClass_Check((x)) || (PyType_Check((x)) &&			\

    99 	  PyType_FastSubclass((PyTypeObject*)(x), Py_TPFLAGS_BASE_EXC_SUBCLASS)))

   100 

   101 #define PyExceptionInstance_Check(x)			\

   102 	(PyInstance_Check((x)) ||			\

   103 	 PyType_FastSubclass((x)->ob_type, Py_TPFLAGS_BASE_EXC_SUBCLASS))

   104 

   105 #define PyExceptionClass_Name(x)				   \

   106 	(PyClass_Check((x))					   \

   107 	 ? PyString_AS_STRING(((PyClassObject*)(x))->cl_name)	   \

   108 	 : (char *)(((PyTypeObject*)(x))->tp_name))

   109 

   110 #define PyExceptionInstance_Class(x)					\

   111 	((PyInstance_Check((x))						\

   112 	  ? (PyObject*)((PyInstanceObject*)(x))->in_class		\

   113 	  : (PyObject*)((x)->ob_type)))

   114 

   115 	

   116 /* Predefined exceptions */

   117 

   118 PyAPI_DATA(PyObject *) PyExc_BaseException;

   119 PyAPI_DATA(PyObject *) PyExc_Exception;

   120 PyAPI_DATA(PyObject *) PyExc_StopIteration;

   121 PyAPI_DATA(PyObject *) PyExc_GeneratorExit;

   122 PyAPI_DATA(PyObject *) PyExc_StandardError;

   123 PyAPI_DATA(PyObject *) PyExc_ArithmeticError;

   124 PyAPI_DATA(PyObject *) PyExc_LookupError;

   125 

   126 PyAPI_DATA(PyObject *) PyExc_AssertionError;

   127 PyAPI_DATA(PyObject *) PyExc_AttributeError;

   128 PyAPI_DATA(PyObject *) PyExc_EOFError;

   129 PyAPI_DATA(PyObject *) PyExc_FloatingPointError;

   130 PyAPI_DATA(PyObject *) PyExc_EnvironmentError;

   131 PyAPI_DATA(PyObject *) PyExc_IOError;

   132 PyAPI_DATA(PyObject *) PyExc_OSError;

   133 PyAPI_DATA(PyObject *) PyExc_ImportError;

   134 PyAPI_DATA(PyObject *) PyExc_IndexError;

   135 PyAPI_DATA(PyObject *) PyExc_KeyError;

   136 PyAPI_DATA(PyObject *) PyExc_KeyboardInterrupt;

   137 PyAPI_DATA(PyObject *) PyExc_MemoryError;

   138 PyAPI_DATA(PyObject *) PyExc_NameError;

   139 PyAPI_DATA(PyObject *) PyExc_OverflowError;

   140 PyAPI_DATA(PyObject *) PyExc_RuntimeError;

   141 PyAPI_DATA(PyObject *) PyExc_NotImplementedError;

   142 PyAPI_DATA(PyObject *) PyExc_SyntaxError;

   143 PyAPI_DATA(PyObject *) PyExc_IndentationError;

   144 PyAPI_DATA(PyObject *) PyExc_TabError;

   145 PyAPI_DATA(PyObject *) PyExc_ReferenceError;

   146 PyAPI_DATA(PyObject *) PyExc_SystemError;

   147 PyAPI_DATA(PyObject *) PyExc_SystemExit;

   148 PyAPI_DATA(PyObject *) PyExc_TypeError;

   149 PyAPI_DATA(PyObject *) PyExc_UnboundLocalError;

   150 PyAPI_DATA(PyObject *) PyExc_UnicodeError;

   151 PyAPI_DATA(PyObject *) PyExc_UnicodeEncodeError;

   152 PyAPI_DATA(PyObject *) PyExc_UnicodeDecodeError;

   153 PyAPI_DATA(PyObject *) PyExc_UnicodeTranslateError;

   154 PyAPI_DATA(PyObject *) PyExc_ValueError;

   155 PyAPI_DATA(PyObject *) PyExc_ZeroDivisionError;

   156 #ifdef MS_WINDOWS

   157 PyAPI_DATA(PyObject *) PyExc_WindowsError;

   158 #endif

   159 #ifdef __VMS

   160 PyAPI_DATA(PyObject *) PyExc_VMSError;

   161 #endif

   162 

   163 PyAPI_DATA(PyObject *) PyExc_BufferError;

   164 

   165 PyAPI_DATA(PyObject *) PyExc_MemoryErrorInst;

   166 PyAPI_DATA(PyObject *) PyExc_RecursionErrorInst;

   167 

   168 /* Predefined warning categories */

   169 PyAPI_DATA(PyObject *) PyExc_Warning;

   170 PyAPI_DATA(PyObject *) PyExc_UserWarning;

   171 PyAPI_DATA(PyObject *) PyExc_DeprecationWarning;

   172 PyAPI_DATA(PyObject *) PyExc_PendingDeprecationWarning;

   173 PyAPI_DATA(PyObject *) PyExc_SyntaxWarning;

   174 PyAPI_DATA(PyObject *) PyExc_RuntimeWarning;

   175 PyAPI_DATA(PyObject *) PyExc_FutureWarning;

   176 PyAPI_DATA(PyObject *) PyExc_ImportWarning;

   177 PyAPI_DATA(PyObject *) PyExc_UnicodeWarning;

   178 PyAPI_DATA(PyObject *) PyExc_BytesWarning;

   179 

   180 

   181 /* Convenience functions */

   182 

   183 PyAPI_FUNC(int) PyErr_BadArgument(void);

   184 PyAPI_FUNC(PyObject *) PyErr_NoMemory(void);

   185 PyAPI_FUNC(PyObject *) PyErr_SetFromErrno(PyObject *);

   186 PyAPI_FUNC(PyObject *) PyErr_SetFromErrnoWithFilenameObject(

   187 	PyObject *, PyObject *);

   188 PyAPI_FUNC(PyObject *) PyErr_SetFromErrnoWithFilename(PyObject *, char *);

   189 #ifdef Py_WIN_WIDE_FILENAMES

   190 PyAPI_FUNC(PyObject *) PyErr_SetFromErrnoWithUnicodeFilename(

   191 	PyObject *, Py_UNICODE *);

   192 #endif /* Py_WIN_WIDE_FILENAMES */

   193 

   194 PyAPI_FUNC(PyObject *) PyErr_Format(PyObject *, const char *, ...)

   195 			Py_GCC_ATTRIBUTE((format(printf, 2, 3)));

   196 

   197 #ifdef MS_WINDOWS

   198 PyAPI_FUNC(PyObject *) PyErr_SetFromWindowsErrWithFilenameObject(

   199 	int, const char *);

   200 PyAPI_FUNC(PyObject *) PyErr_SetFromWindowsErrWithFilename(

   201 	int, const char *);

   202 #ifdef Py_WIN_WIDE_FILENAMES

   203 PyAPI_FUNC(PyObject *) PyErr_SetFromWindowsErrWithUnicodeFilename(

   204 	int, const Py_UNICODE *);

   205 #endif /* Py_WIN_WIDE_FILENAMES */

   206 PyAPI_FUNC(PyObject *) PyErr_SetFromWindowsErr(int);

   207 PyAPI_FUNC(PyObject *) PyErr_SetExcFromWindowsErrWithFilenameObject(

   208 	PyObject *,int, PyObject *);

   209 PyAPI_FUNC(PyObject *) PyErr_SetExcFromWindowsErrWithFilename(

   210 	PyObject *,int, const char *);

   211 #ifdef Py_WIN_WIDE_FILENAMES

   212 PyAPI_FUNC(PyObject *) PyErr_SetExcFromWindowsErrWithUnicodeFilename(

   213 	PyObject *,int, const Py_UNICODE *);

   214 #endif /* Py_WIN_WIDE_FILENAMES */

   215 PyAPI_FUNC(PyObject *) PyErr_SetExcFromWindowsErr(PyObject *, int);

   216 #endif /* MS_WINDOWS */

   217 

   218 /* Export the old function so that the existing API remains available: */

   219 PyAPI_FUNC(void) PyErr_BadInternalCall(void);

   220 PyAPI_FUNC(void) _PyErr_BadInternalCall(char *filename, int lineno);

   221 /* Mask the old API with a call to the new API for code compiled under

   222    Python 2.0: */

   223 #define PyErr_BadInternalCall() _PyErr_BadInternalCall(__FILE__, __LINE__)

   224 

   225 /* Function to create a new exception */

   226 PyAPI_FUNC(PyObject *) PyErr_NewException(char *name, PyObject *base,

   227                                          PyObject *dict);

   228 PyAPI_FUNC(void) PyErr_WriteUnraisable(PyObject *);

   229 

   230 /* In sigcheck.c or signalmodule.c */

   231 PyAPI_FUNC(int) PyErr_CheckSignals(void);

   232 PyAPI_FUNC(void) PyErr_SetInterrupt(void);

   233 

   234 /* In signalmodule.c */

   235 int PySignal_SetWakeupFd(int fd);

   236 

   237 /* Support for adding program text to SyntaxErrors */

   238 PyAPI_FUNC(void) PyErr_SyntaxLocation(const char *, int);

   239 PyAPI_FUNC(PyObject *) PyErr_ProgramText(const char *, int);

   240 

   241 #ifdef Py_USING_UNICODE

   242 /* The following functions are used to create and modify unicode

   243    exceptions from C */

   244 

   245 /* create a UnicodeDecodeError object */

   246 PyAPI_FUNC(PyObject *) PyUnicodeDecodeError_Create(

   247 	const char *, const char *, Py_ssize_t, Py_ssize_t, Py_ssize_t, const char *);

   248 

   249 /* create a UnicodeEncodeError object */

   250 PyAPI_FUNC(PyObject *) PyUnicodeEncodeError_Create(

   251 	const char *, const Py_UNICODE *, Py_ssize_t, Py_ssize_t, Py_ssize_t, const char *);

   252 

   253 /* create a UnicodeTranslateError object */

   254 PyAPI_FUNC(PyObject *) PyUnicodeTranslateError_Create(

   255 	const Py_UNICODE *, Py_ssize_t, Py_ssize_t, Py_ssize_t, const char *);

   256 

   257 /* get the encoding attribute */

   258 PyAPI_FUNC(PyObject *) PyUnicodeEncodeError_GetEncoding(PyObject *);

   259 PyAPI_FUNC(PyObject *) PyUnicodeDecodeError_GetEncoding(PyObject *);

   260 

   261 /* get the object attribute */

   262 PyAPI_FUNC(PyObject *) PyUnicodeEncodeError_GetObject(PyObject *);

   263 PyAPI_FUNC(PyObject *) PyUnicodeDecodeError_GetObject(PyObject *);

   264 PyAPI_FUNC(PyObject *) PyUnicodeTranslateError_GetObject(PyObject *);

   265 

   266 /* get the value of the start attribute (the int * may not be NULL)

   267    return 0 on success, -1 on failure */

   268 PyAPI_FUNC(int) PyUnicodeEncodeError_GetStart(PyObject *, Py_ssize_t *);

   269 PyAPI_FUNC(int) PyUnicodeDecodeError_GetStart(PyObject *, Py_ssize_t *);

   270 PyAPI_FUNC(int) PyUnicodeTranslateError_GetStart(PyObject *, Py_ssize_t *);

   271 

   272 /* assign a new value to the start attribute

   273    return 0 on success, -1 on failure */

   274 PyAPI_FUNC(int) PyUnicodeEncodeError_SetStart(PyObject *, Py_ssize_t);

   275 PyAPI_FUNC(int) PyUnicodeDecodeError_SetStart(PyObject *, Py_ssize_t);

   276 PyAPI_FUNC(int) PyUnicodeTranslateError_SetStart(PyObject *, Py_ssize_t);

   277 

   278 /* get the value of the end attribute (the int *may not be NULL)

   279  return 0 on success, -1 on failure */

   280 PyAPI_FUNC(int) PyUnicodeEncodeError_GetEnd(PyObject *, Py_ssize_t *);

   281 PyAPI_FUNC(int) PyUnicodeDecodeError_GetEnd(PyObject *, Py_ssize_t *);

   282 PyAPI_FUNC(int) PyUnicodeTranslateError_GetEnd(PyObject *, Py_ssize_t *);

   283 

   284 /* assign a new value to the end attribute

   285    return 0 on success, -1 on failure */

   286 PyAPI_FUNC(int) PyUnicodeEncodeError_SetEnd(PyObject *, Py_ssize_t);

   287 PyAPI_FUNC(int) PyUnicodeDecodeError_SetEnd(PyObject *, Py_ssize_t);

   288 PyAPI_FUNC(int) PyUnicodeTranslateError_SetEnd(PyObject *, Py_ssize_t);

   289 

   290 /* get the value of the reason attribute */

   291 PyAPI_FUNC(PyObject *) PyUnicodeEncodeError_GetReason(PyObject *);

   292 PyAPI_FUNC(PyObject *) PyUnicodeDecodeError_GetReason(PyObject *);

   293 PyAPI_FUNC(PyObject *) PyUnicodeTranslateError_GetReason(PyObject *);

   294 

   295 /* assign a new value to the reason attribute

   296    return 0 on success, -1 on failure */

   297 PyAPI_FUNC(int) PyUnicodeEncodeError_SetReason(

   298 	PyObject *, const char *);

   299 PyAPI_FUNC(int) PyUnicodeDecodeError_SetReason(

   300 	PyObject *, const char *);

   301 PyAPI_FUNC(int) PyUnicodeTranslateError_SetReason(

   302 	PyObject *, const char *);

   303 #endif

   304 

   305 

   306 /* These APIs aren't really part of the error implementation, but

   307    often needed to format error messages; the native C lib APIs are

   308    not available on all platforms, which is why we provide emulations

   309    for those platforms in Python/mysnprintf.c,

   310    WARNING:  The return value of snprintf varies across platforms; do

   311    not rely on any particular behavior; eventually the C99 defn may

   312    be reliable.

   313 */

   314 #if defined(MS_WIN32) && !defined(HAVE_SNPRINTF)

   315 # define HAVE_SNPRINTF

   316 # define snprintf _snprintf

   317 # define vsnprintf _vsnprintf

   318 #endif

   319 

   320 #include <stdarg.h>

   321 PyAPI_FUNC(int) PyOS_snprintf(char *str, size_t size, const char  *format, ...)

   322 			Py_GCC_ATTRIBUTE((format(printf, 3, 4)));

   323 PyAPI_FUNC(int) PyOS_vsnprintf(char *str, size_t size, const char  *format, va_list va)

   324 			Py_GCC_ATTRIBUTE((format(printf, 3, 0)));

   325 

   326 #ifdef __cplusplus

   327 }

   328 #endif

   329 #endif /* !Py_ERRORS_H */