blob: c8c3d823118a6fc1dc8dd63a4698fa522dacfe86 [file] [log] [blame]
Guido van Rossuma3309961993-07-28 09:05:47 +00001#ifndef Py_ERRORS_H
2#define Py_ERRORS_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
Guido van Rossumf70e43a1991-02-19 12:39:46 +00007
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00008/* Error handling definitions */
9
Fred Draked5c84ed2000-07-08 17:25:55 +000010DL_IMPORT(void) PyErr_SetNone(PyObject *);
11DL_IMPORT(void) PyErr_SetObject(PyObject *, PyObject *);
12DL_IMPORT(void) PyErr_SetString(PyObject *, const char *);
13DL_IMPORT(PyObject *) PyErr_Occurred(void);
14DL_IMPORT(void) PyErr_Clear(void);
15DL_IMPORT(void) PyErr_Fetch(PyObject **, PyObject **, PyObject **);
16DL_IMPORT(void) PyErr_Restore(PyObject *, PyObject *, PyObject *);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000017
Barry Warsawc0dc92a1997-08-22 21:22:58 +000018/* Error testing and normalization */
Fred Draked5c84ed2000-07-08 17:25:55 +000019DL_IMPORT(int) PyErr_GivenExceptionMatches(PyObject *, PyObject *);
20DL_IMPORT(int) PyErr_ExceptionMatches(PyObject *);
21DL_IMPORT(void) PyErr_NormalizeException(PyObject**, PyObject**, PyObject**);
Barry Warsawc0dc92a1997-08-22 21:22:58 +000022
23
Guido van Rossum3f5da241990-12-20 15:06:42 +000024/* Predefined exceptions */
Guido van Rossum5c600e11990-10-14 20:00:25 +000025
Guido van Rossum04748321997-09-16 18:43:15 +000026extern DL_IMPORT(PyObject *) PyExc_Exception;
Barry Warsaw392d8271997-08-29 21:56:07 +000027extern DL_IMPORT(PyObject *) PyExc_StandardError;
Barry Warsaw65349a31997-09-16 21:50:36 +000028extern DL_IMPORT(PyObject *) PyExc_ArithmeticError;
Barry Warsaw392d8271997-08-29 21:56:07 +000029extern DL_IMPORT(PyObject *) PyExc_LookupError;
30
Guido van Rossum6fa44661997-04-02 05:22:53 +000031extern DL_IMPORT(PyObject *) PyExc_AssertionError;
Guido van Rossum051ab121995-02-27 10:17:52 +000032extern DL_IMPORT(PyObject *) PyExc_AttributeError;
Guido van Rossum051ab121995-02-27 10:17:52 +000033extern DL_IMPORT(PyObject *) PyExc_EOFError;
Guido van Rossum7d4266e1997-02-14 22:53:12 +000034extern DL_IMPORT(PyObject *) PyExc_FloatingPointError;
Barry Warsaw62a21a21998-07-23 15:57:34 +000035extern DL_IMPORT(PyObject *) PyExc_EnvironmentError;
Guido van Rossum051ab121995-02-27 10:17:52 +000036extern DL_IMPORT(PyObject *) PyExc_IOError;
Barry Warsaw62a21a21998-07-23 15:57:34 +000037extern DL_IMPORT(PyObject *) PyExc_OSError;
Guido van Rossum051ab121995-02-27 10:17:52 +000038extern DL_IMPORT(PyObject *) PyExc_ImportError;
39extern DL_IMPORT(PyObject *) PyExc_IndexError;
40extern DL_IMPORT(PyObject *) PyExc_KeyError;
41extern DL_IMPORT(PyObject *) PyExc_KeyboardInterrupt;
42extern DL_IMPORT(PyObject *) PyExc_MemoryError;
43extern DL_IMPORT(PyObject *) PyExc_NameError;
44extern DL_IMPORT(PyObject *) PyExc_OverflowError;
45extern DL_IMPORT(PyObject *) PyExc_RuntimeError;
Barry Warsawd052ff01998-12-01 18:34:01 +000046extern DL_IMPORT(PyObject *) PyExc_NotImplementedError;
Guido van Rossum051ab121995-02-27 10:17:52 +000047extern DL_IMPORT(PyObject *) PyExc_SyntaxError;
Fred Draked5c84ed2000-07-08 17:25:55 +000048extern DL_IMPORT(PyObject *) PyExc_IndentationError;
49extern DL_IMPORT(PyObject *) PyExc_TabError;
Guido van Rossum051ab121995-02-27 10:17:52 +000050extern DL_IMPORT(PyObject *) PyExc_SystemError;
51extern DL_IMPORT(PyObject *) PyExc_SystemExit;
52extern DL_IMPORT(PyObject *) PyExc_TypeError;
Guido van Rossum87460821999-06-22 14:47:32 +000053extern DL_IMPORT(PyObject *) PyExc_UnboundLocalError;
Guido van Rossum99cc9712000-03-10 22:33:32 +000054extern DL_IMPORT(PyObject *) PyExc_UnicodeError;
Guido van Rossum051ab121995-02-27 10:17:52 +000055extern DL_IMPORT(PyObject *) PyExc_ValueError;
56extern DL_IMPORT(PyObject *) PyExc_ZeroDivisionError;
Guido van Rossumdb0c9f72000-02-17 15:17:18 +000057#ifdef MS_WINDOWS
58extern DL_IMPORT(PyObject *) PyExc_WindowsError;
59#endif
Guido van Rossum3e55cb61990-10-21 22:09:30 +000060
Barry Warsaw392d8271997-08-29 21:56:07 +000061extern DL_IMPORT(PyObject *) PyExc_MemoryErrorInst;
62
Guido van Rossum3fc30372000-12-15 21:57:34 +000063/* Predefined warning categories */
64extern DL_IMPORT(PyObject *) PyExc_Warning;
65extern DL_IMPORT(PyObject *) PyExc_UserWarning;
66extern DL_IMPORT(PyObject *) PyExc_DeprecationWarning;
67extern DL_IMPORT(PyObject *) PyExc_SyntaxWarning;
68extern DL_IMPORT(PyObject *) PyExc_RuntimeWarning;
69
Barry Warsaw392d8271997-08-29 21:56:07 +000070
Guido van Rossum5c600e11990-10-14 20:00:25 +000071/* Convenience functions */
72
Fred Draked5c84ed2000-07-08 17:25:55 +000073extern DL_IMPORT(int) PyErr_BadArgument(void);
74extern DL_IMPORT(PyObject *) PyErr_NoMemory(void);
75extern DL_IMPORT(PyObject *) PyErr_SetFromErrno(PyObject *);
76extern DL_IMPORT(PyObject *) PyErr_SetFromErrnoWithFilename(PyObject *, char *);
77extern DL_IMPORT(PyObject *) PyErr_Format(PyObject *, const char *, ...);
Guido van Rossumdb0c9f72000-02-17 15:17:18 +000078#ifdef MS_WINDOWS
79extern DL_IMPORT(PyObject *) PyErr_SetFromWindowsErrWithFilename(int, const char *);
80extern DL_IMPORT(PyObject *) PyErr_SetFromWindowsErr(int);
81#endif
Guido van Rossum3e55cb61990-10-21 22:09:30 +000082
Fred Drake6d63adf2000-08-24 22:38:39 +000083/* Export the old function so that the existing API remains available: */
Fred Draked5c84ed2000-07-08 17:25:55 +000084extern DL_IMPORT(void) PyErr_BadInternalCall(void);
Fred Drake6d63adf2000-08-24 22:38:39 +000085extern DL_IMPORT(void) _PyErr_BadInternalCall(char *filename, int lineno);
86/* Mask the old API with a call to the new API for code compiled under
87 Python 2.0: */
88#define PyErr_BadInternalCall() _PyErr_BadInternalCall(__FILE__, __LINE__)
Guido van Rossum25831651993-05-19 14:50:45 +000089
Guido van Rossum2d2c3441997-09-16 21:50:37 +000090/* Function to create a new exception */
Fred Draked5c84ed2000-07-08 17:25:55 +000091DL_IMPORT(PyObject *) PyErr_NewException(char *name, PyObject *base,
92 PyObject *dict);
Jeremy Hyltonb709df32000-09-01 02:47:25 +000093extern DL_IMPORT(void) PyErr_WriteUnraisable(PyObject *);
Guido van Rossum2d2c3441997-09-16 21:50:37 +000094
Guido van Rossum3fc30372000-12-15 21:57:34 +000095/* Issue a warning or exception */
96extern DL_IMPORT(int) PyErr_Warn(PyObject *, char *);
97
Barry Warsawf3f41a91997-01-03 00:15:03 +000098/* In sigcheck.c or signalmodule.c */
Fred Draked5c84ed2000-07-08 17:25:55 +000099extern DL_IMPORT(int) PyErr_CheckSignals(void);
100extern DL_IMPORT(void) PyErr_SetInterrupt(void);
Barry Warsawf3f41a91997-01-03 00:15:03 +0000101
Guido van Rossumb6775db1994-08-01 11:34:53 +0000102
Guido van Rossuma3309961993-07-28 09:05:47 +0000103#ifdef __cplusplus
104}
105#endif
106#endif /* !Py_ERRORS_H */