1993-07-28 09:05:47 +00:00
|
|
|
#ifndef Py_ERRORS_H
|
|
|
|
#define Py_ERRORS_H
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
1991-02-19 12:39:46 +00:00
|
|
|
|
1990-10-14 12:07:46 +00:00
|
|
|
/* Error handling definitions */
|
|
|
|
|
2000-07-08 17:25:55 +00:00
|
|
|
DL_IMPORT(void) PyErr_SetNone(PyObject *);
|
|
|
|
DL_IMPORT(void) PyErr_SetObject(PyObject *, PyObject *);
|
|
|
|
DL_IMPORT(void) PyErr_SetString(PyObject *, const char *);
|
|
|
|
DL_IMPORT(PyObject *) PyErr_Occurred(void);
|
|
|
|
DL_IMPORT(void) PyErr_Clear(void);
|
|
|
|
DL_IMPORT(void) PyErr_Fetch(PyObject **, PyObject **, PyObject **);
|
|
|
|
DL_IMPORT(void) PyErr_Restore(PyObject *, PyObject *, PyObject *);
|
1990-10-14 12:07:46 +00:00
|
|
|
|
Three new C API functions:
- int PyErr_GivenExceptionMatches(obj1, obj2)
Returns 1 if obj1 and obj2 are the same object, or if obj1 is an
instance of type obj2, or of a class derived from obj2
- int PyErr_ExceptionMatches(obj)
Higher level wrapper around PyErr_GivenExceptionMatches() which uses
PyErr_Occurred() as obj1. This will be the more commonly called
function.
- void PyErr_NormalizeException(typeptr, valptr, tbptr)
Normalizes exceptions, and places the normalized values in the
arguments. If type is not a class, this does nothing. If type is a
class, then it makes sure that value is an instance of the class by:
1. if instance is of the type, or a class derived from type, it does
nothing.
2. otherwise it instantiates the class, using the value as an
argument. If value is None, it uses an empty arg tuple, and if
the value is a tuple, it uses just that.
1997-08-22 21:22:58 +00:00
|
|
|
/* Error testing and normalization */
|
2000-07-08 17:25:55 +00:00
|
|
|
DL_IMPORT(int) PyErr_GivenExceptionMatches(PyObject *, PyObject *);
|
|
|
|
DL_IMPORT(int) PyErr_ExceptionMatches(PyObject *);
|
|
|
|
DL_IMPORT(void) PyErr_NormalizeException(PyObject**, PyObject**, PyObject**);
|
Three new C API functions:
- int PyErr_GivenExceptionMatches(obj1, obj2)
Returns 1 if obj1 and obj2 are the same object, or if obj1 is an
instance of type obj2, or of a class derived from obj2
- int PyErr_ExceptionMatches(obj)
Higher level wrapper around PyErr_GivenExceptionMatches() which uses
PyErr_Occurred() as obj1. This will be the more commonly called
function.
- void PyErr_NormalizeException(typeptr, valptr, tbptr)
Normalizes exceptions, and places the normalized values in the
arguments. If type is not a class, this does nothing. If type is a
class, then it makes sure that value is an instance of the class by:
1. if instance is of the type, or a class derived from type, it does
nothing.
2. otherwise it instantiates the class, using the value as an
argument. If value is None, it uses an empty arg tuple, and if
the value is a tuple, it uses just that.
1997-08-22 21:22:58 +00:00
|
|
|
|
|
|
|
|
1990-12-20 15:06:42 +00:00
|
|
|
/* Predefined exceptions */
|
1990-10-14 20:00:25 +00:00
|
|
|
|
1997-09-16 18:43:15 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_Exception;
|
1997-08-29 21:56:07 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_StandardError;
|
1997-09-16 21:50:36 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_ArithmeticError;
|
1997-08-29 21:56:07 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_LookupError;
|
|
|
|
|
1997-04-02 05:22:53 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_AssertionError;
|
1995-02-27 10:17:52 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_AttributeError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_EOFError;
|
1997-02-14 22:53:12 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_FloatingPointError;
|
1998-07-23 15:57:34 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_EnvironmentError;
|
1995-02-27 10:17:52 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_IOError;
|
1998-07-23 15:57:34 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_OSError;
|
1995-02-27 10:17:52 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_ImportError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_IndexError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_KeyError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_KeyboardInterrupt;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_MemoryError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_NameError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_OverflowError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_RuntimeError;
|
1998-12-01 18:34:01 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_NotImplementedError;
|
1995-02-27 10:17:52 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_SyntaxError;
|
2000-07-08 17:25:55 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_IndentationError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_TabError;
|
1995-02-27 10:17:52 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_SystemError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_SystemExit;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_TypeError;
|
Patch by Tim Peters:
Introduce a new builtin exception, UnboundLocalError, raised when ceval.c
tries to retrieve or delete a local name that isn't bound to a value.
Currently raises NameError, which makes this behavior a FAQ since the same
error is raised for "missing" global names too: when the user has a global
of the same name as the unbound local, NameError makes no sense to them.
Even in the absence of shadowing, knowing whether a bogus name is local or
global is a real aid to quick understanding.
Example:
D:\src\PCbuild>type local.py
x = 42
def f():
print x
x = 13
return x
f()
D:\src\PCbuild>python local.py
Traceback (innermost last):
File "local.py", line 8, in ?
f()
File "local.py", line 4, in f
print x
UnboundLocalError: x
D:\src\PCbuild>
Note that UnboundLocalError is a subclass of NameError, for compatibility
with existing class-exception code that may be trying to catch this as a
NameError. Unfortunately, I see no way to make this wholly compatible
with -X (see comments in bltinmodule.c): under -X, [UnboundLocalError
is an alias for NameError --GvR].
[The ceval.c patch differs slightly from the second version that Tim
submitted; I decided not to raise UnboundLocalError for DELETE_NAME,
only for DELETE_LOCAL. DELETE_NAME is only generated at the module
level, and since at that level a NameError is raised for referencing
an undefined name, it should also be raised for deleting one.]
1999-06-22 14:47:32 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_UnboundLocalError;
|
2000-03-10 22:33:32 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_UnicodeError;
|
1995-02-27 10:17:52 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_ValueError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_ZeroDivisionError;
|
2000-02-17 15:17:18 +00:00
|
|
|
#ifdef MS_WINDOWS
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_WindowsError;
|
|
|
|
#endif
|
1990-10-21 22:09:30 +00:00
|
|
|
|
1997-08-29 21:56:07 +00:00
|
|
|
extern DL_IMPORT(PyObject *) PyExc_MemoryErrorInst;
|
|
|
|
|
2000-12-15 21:57:34 +00:00
|
|
|
/* Predefined warning categories */
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_Warning;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_UserWarning;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_DeprecationWarning;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_SyntaxWarning;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_RuntimeWarning;
|
|
|
|
|
1997-08-29 21:56:07 +00:00
|
|
|
|
1990-10-14 20:00:25 +00:00
|
|
|
/* Convenience functions */
|
|
|
|
|
2000-07-08 17:25:55 +00:00
|
|
|
extern DL_IMPORT(int) PyErr_BadArgument(void);
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_NoMemory(void);
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_SetFromErrno(PyObject *);
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_SetFromErrnoWithFilename(PyObject *, char *);
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_Format(PyObject *, const char *, ...);
|
2000-02-17 15:17:18 +00:00
|
|
|
#ifdef MS_WINDOWS
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_SetFromWindowsErrWithFilename(int, const char *);
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_SetFromWindowsErr(int);
|
|
|
|
#endif
|
1990-10-21 22:09:30 +00:00
|
|
|
|
2000-08-24 22:38:39 +00:00
|
|
|
/* Export the old function so that the existing API remains available: */
|
2000-07-08 17:25:55 +00:00
|
|
|
extern DL_IMPORT(void) PyErr_BadInternalCall(void);
|
2000-08-24 22:38:39 +00:00
|
|
|
extern DL_IMPORT(void) _PyErr_BadInternalCall(char *filename, int lineno);
|
|
|
|
/* Mask the old API with a call to the new API for code compiled under
|
|
|
|
Python 2.0: */
|
|
|
|
#define PyErr_BadInternalCall() _PyErr_BadInternalCall(__FILE__, __LINE__)
|
1993-05-19 14:50:45 +00:00
|
|
|
|
1997-09-16 21:50:37 +00:00
|
|
|
/* Function to create a new exception */
|
2000-07-08 17:25:55 +00:00
|
|
|
DL_IMPORT(PyObject *) PyErr_NewException(char *name, PyObject *base,
|
|
|
|
PyObject *dict);
|
2000-09-01 02:47:25 +00:00
|
|
|
extern DL_IMPORT(void) PyErr_WriteUnraisable(PyObject *);
|
1997-09-16 21:50:37 +00:00
|
|
|
|
2000-12-15 21:57:34 +00:00
|
|
|
/* Issue a warning or exception */
|
|
|
|
extern DL_IMPORT(int) PyErr_Warn(PyObject *, char *);
|
2001-02-28 21:44:20 +00:00
|
|
|
extern DL_IMPORT(int) PyErr_WarnExplicit(PyObject *, char *,
|
|
|
|
char *, int, char *, PyObject *);
|
2000-12-15 21:57:34 +00:00
|
|
|
|
1997-01-03 00:15:03 +00:00
|
|
|
/* In sigcheck.c or signalmodule.c */
|
2000-07-08 17:25:55 +00:00
|
|
|
extern DL_IMPORT(int) PyErr_CheckSignals(void);
|
|
|
|
extern DL_IMPORT(void) PyErr_SetInterrupt(void);
|
2001-02-28 17:47:12 +00:00
|
|
|
|
|
|
|
/* Support for adding program text to SyntaxErrors */
|
|
|
|
extern DL_IMPORT(void) PyErr_SyntaxLocation(char *, int);
|
|
|
|
extern DL_IMPORT(PyObject *) PyErr_ProgramText(char *, int);
|
1997-01-03 00:15:03 +00:00
|
|
|
|
1994-08-01 11:34:53 +00:00
|
|
|
|
1993-07-28 09:05:47 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif /* !Py_ERRORS_H */
|