mirror of
https://github.com/python/cpython.git
synced 2024-12-01 11:15:56 +01:00
8746082175
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.]
111 lines
4.5 KiB
C
111 lines
4.5 KiB
C
#ifndef Py_ERRORS_H
|
|
#define Py_ERRORS_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/***********************************************************
|
|
Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
|
|
The Netherlands.
|
|
|
|
All Rights Reserved
|
|
|
|
Permission to use, copy, modify, and distribute this software and its
|
|
documentation for any purpose and without fee is hereby granted,
|
|
provided that the above copyright notice appear in all copies and that
|
|
both that copyright notice and this permission notice appear in
|
|
supporting documentation, and that the names of Stichting Mathematisch
|
|
Centrum or CWI or Corporation for National Research Initiatives or
|
|
CNRI not be used in advertising or publicity pertaining to
|
|
distribution of the software without specific, written prior
|
|
permission.
|
|
|
|
While CWI is the initial source for this software, a modified version
|
|
is made available by the Corporation for National Research Initiatives
|
|
(CNRI) at the Internet address ftp://ftp.python.org.
|
|
|
|
STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
|
|
REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
|
|
MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
|
|
CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
|
|
DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
|
|
PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
******************************************************************/
|
|
|
|
/* Error handling definitions */
|
|
|
|
DL_IMPORT(void) PyErr_SetNone Py_PROTO((PyObject *));
|
|
DL_IMPORT(void) PyErr_SetObject Py_PROTO((PyObject *, PyObject *));
|
|
DL_IMPORT(void) PyErr_SetString Py_PROTO((PyObject *, const char *));
|
|
DL_IMPORT(PyObject *) PyErr_Occurred Py_PROTO((void));
|
|
DL_IMPORT(void) PyErr_Clear Py_PROTO((void));
|
|
DL_IMPORT(void) PyErr_Fetch Py_PROTO((PyObject **, PyObject **, PyObject **));
|
|
DL_IMPORT(void) PyErr_Restore Py_PROTO((PyObject *, PyObject *, PyObject *));
|
|
|
|
/* Error testing and normalization */
|
|
DL_IMPORT(int) PyErr_GivenExceptionMatches Py_PROTO((PyObject *, PyObject *));
|
|
DL_IMPORT(int) PyErr_ExceptionMatches Py_PROTO((PyObject *));
|
|
DL_IMPORT(void) PyErr_NormalizeException Py_PROTO((PyObject**, PyObject**, PyObject**));
|
|
|
|
|
|
/* Predefined exceptions */
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_Exception;
|
|
extern DL_IMPORT(PyObject *) PyExc_StandardError;
|
|
extern DL_IMPORT(PyObject *) PyExc_ArithmeticError;
|
|
extern DL_IMPORT(PyObject *) PyExc_LookupError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_AssertionError;
|
|
extern DL_IMPORT(PyObject *) PyExc_AttributeError;
|
|
extern DL_IMPORT(PyObject *) PyExc_EOFError;
|
|
extern DL_IMPORT(PyObject *) PyExc_FloatingPointError;
|
|
extern DL_IMPORT(PyObject *) PyExc_EnvironmentError;
|
|
extern DL_IMPORT(PyObject *) PyExc_IOError;
|
|
extern DL_IMPORT(PyObject *) PyExc_OSError;
|
|
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;
|
|
extern DL_IMPORT(PyObject *) PyExc_NotImplementedError;
|
|
extern DL_IMPORT(PyObject *) PyExc_SyntaxError;
|
|
extern DL_IMPORT(PyObject *) PyExc_SystemError;
|
|
extern DL_IMPORT(PyObject *) PyExc_SystemExit;
|
|
extern DL_IMPORT(PyObject *) PyExc_TypeError;
|
|
extern DL_IMPORT(PyObject *) PyExc_UnboundLocalError;
|
|
extern DL_IMPORT(PyObject *) PyExc_ValueError;
|
|
extern DL_IMPORT(PyObject *) PyExc_ZeroDivisionError;
|
|
|
|
extern DL_IMPORT(PyObject *) PyExc_MemoryErrorInst;
|
|
|
|
|
|
/* Convenience functions */
|
|
|
|
extern DL_IMPORT(int) PyErr_BadArgument Py_PROTO((void));
|
|
extern DL_IMPORT(PyObject *) PyErr_NoMemory Py_PROTO((void));
|
|
extern DL_IMPORT(PyObject *) PyErr_SetFromErrno Py_PROTO((PyObject *));
|
|
extern DL_IMPORT(PyObject *) PyErr_SetFromErrnoWithFilename Py_PROTO((PyObject *, char *));
|
|
extern DL_IMPORT(PyObject *) PyErr_Format Py_PROTO((PyObject *, const char *, ...));
|
|
|
|
extern DL_IMPORT(void) PyErr_BadInternalCall Py_PROTO((void));
|
|
|
|
/* Function to create a new exception */
|
|
DL_IMPORT(PyObject *) PyErr_NewException Py_PROTO((char *name, PyObject *base,
|
|
PyObject *dict));
|
|
|
|
/* In sigcheck.c or signalmodule.c */
|
|
extern DL_IMPORT(int) PyErr_CheckSignals Py_PROTO((void));
|
|
extern DL_IMPORT(void) PyErr_SetInterrupt Py_PROTO((void));
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_ERRORS_H */
|