Automatic conversion of floats to integers for struct.pack integer codes
[python.git] / Objects / exceptions.c
blob2f2a330f923edab17a95a8c9401ae3b536b77549
1 /*
2 * New exceptions.c written in Iceland by Richard Jones and Georg Brandl.
4 * Thanks go to Tim Peters and Michael Hudson for debugging.
5 */
7 #define PY_SSIZE_T_CLEAN
8 #include <Python.h>
9 #include "structmember.h"
10 #include "osdefs.h"
12 #define MAKE_IT_NONE(x) (x) = Py_None; Py_INCREF(Py_None);
13 #define EXC_MODULE_NAME "exceptions."
15 /* NOTE: If the exception class hierarchy changes, don't forget to update
16 * Lib/test/exception_hierarchy.txt
19 PyDoc_STRVAR(exceptions_doc, "Python's standard exception class hierarchy.\n\
20 \n\
21 Exceptions found here are defined both in the exceptions module and the\n\
22 built-in namespace. It is recommended that user-defined exceptions\n\
23 inherit from Exception. See the documentation for the exception\n\
24 inheritance hierarchy.\n\
25 ");
28 * BaseException
30 static PyObject *
31 BaseException_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
33 PyBaseExceptionObject *self;
35 self = (PyBaseExceptionObject *)type->tp_alloc(type, 0);
36 if (!self)
37 return NULL;
38 /* the dict is created on the fly in PyObject_GenericSetAttr */
39 self->message = self->dict = NULL;
41 self->args = PyTuple_New(0);
42 if (!self->args) {
43 Py_DECREF(self);
44 return NULL;
47 self->message = PyString_FromString("");
48 if (!self->message) {
49 Py_DECREF(self);
50 return NULL;
53 return (PyObject *)self;
56 static int
57 BaseException_init(PyBaseExceptionObject *self, PyObject *args, PyObject *kwds)
59 if (!_PyArg_NoKeywords(Py_TYPE(self)->tp_name, kwds))
60 return -1;
62 Py_DECREF(self->args);
63 self->args = args;
64 Py_INCREF(self->args);
66 if (PyTuple_GET_SIZE(self->args) == 1) {
67 Py_CLEAR(self->message);
68 self->message = PyTuple_GET_ITEM(self->args, 0);
69 Py_INCREF(self->message);
71 return 0;
74 static int
75 BaseException_clear(PyBaseExceptionObject *self)
77 Py_CLEAR(self->dict);
78 Py_CLEAR(self->args);
79 Py_CLEAR(self->message);
80 return 0;
83 static void
84 BaseException_dealloc(PyBaseExceptionObject *self)
86 _PyObject_GC_UNTRACK(self);
87 BaseException_clear(self);
88 Py_TYPE(self)->tp_free((PyObject *)self);
91 static int
92 BaseException_traverse(PyBaseExceptionObject *self, visitproc visit, void *arg)
94 Py_VISIT(self->dict);
95 Py_VISIT(self->args);
96 Py_VISIT(self->message);
97 return 0;
100 static PyObject *
101 BaseException_str(PyBaseExceptionObject *self)
103 PyObject *out;
105 switch (PyTuple_GET_SIZE(self->args)) {
106 case 0:
107 out = PyString_FromString("");
108 break;
109 case 1:
110 out = PyObject_Str(PyTuple_GET_ITEM(self->args, 0));
111 break;
112 default:
113 out = PyObject_Str(self->args);
114 break;
117 return out;
120 #ifdef Py_USING_UNICODE
121 static PyObject *
122 BaseException_unicode(PyBaseExceptionObject *self)
124 PyObject *out;
126 switch (PyTuple_GET_SIZE(self->args)) {
127 case 0:
128 out = PyUnicode_FromString("");
129 break;
130 case 1:
131 out = PyObject_Unicode(PyTuple_GET_ITEM(self->args, 0));
132 break;
133 default:
134 out = PyObject_Unicode(self->args);
135 break;
138 return out;
140 #endif
142 static PyObject *
143 BaseException_repr(PyBaseExceptionObject *self)
145 PyObject *repr_suffix;
146 PyObject *repr;
147 char *name;
148 char *dot;
150 repr_suffix = PyObject_Repr(self->args);
151 if (!repr_suffix)
152 return NULL;
154 name = (char *)Py_TYPE(self)->tp_name;
155 dot = strrchr(name, '.');
156 if (dot != NULL) name = dot+1;
158 repr = PyString_FromString(name);
159 if (!repr) {
160 Py_DECREF(repr_suffix);
161 return NULL;
164 PyString_ConcatAndDel(&repr, repr_suffix);
165 return repr;
168 /* Pickling support */
169 static PyObject *
170 BaseException_reduce(PyBaseExceptionObject *self)
172 if (self->args && self->dict)
173 return PyTuple_Pack(3, Py_TYPE(self), self->args, self->dict);
174 else
175 return PyTuple_Pack(2, Py_TYPE(self), self->args);
179 * Needed for backward compatibility, since exceptions used to store
180 * all their attributes in the __dict__. Code is taken from cPickle's
181 * load_build function.
183 static PyObject *
184 BaseException_setstate(PyObject *self, PyObject *state)
186 PyObject *d_key, *d_value;
187 Py_ssize_t i = 0;
189 if (state != Py_None) {
190 if (!PyDict_Check(state)) {
191 PyErr_SetString(PyExc_TypeError, "state is not a dictionary");
192 return NULL;
194 while (PyDict_Next(state, &i, &d_key, &d_value)) {
195 if (PyObject_SetAttr(self, d_key, d_value) < 0)
196 return NULL;
199 Py_RETURN_NONE;
203 static PyMethodDef BaseException_methods[] = {
204 {"__reduce__", (PyCFunction)BaseException_reduce, METH_NOARGS },
205 {"__setstate__", (PyCFunction)BaseException_setstate, METH_O },
206 #ifdef Py_USING_UNICODE
207 {"__unicode__", (PyCFunction)BaseException_unicode, METH_NOARGS },
208 #endif
209 {NULL, NULL, 0, NULL},
214 static PyObject *
215 BaseException_getitem(PyBaseExceptionObject *self, Py_ssize_t index)
217 if (PyErr_WarnPy3k("__getitem__ not supported for exception "
218 "classes in 3.x; use args attribute", 1) < 0)
219 return NULL;
220 return PySequence_GetItem(self->args, index);
223 static PyObject *
224 BaseException_getslice(PyBaseExceptionObject *self,
225 Py_ssize_t start, Py_ssize_t stop)
227 if (PyErr_WarnPy3k("__getslice__ not supported for exception "
228 "classes in 3.x; use args attribute", 1) < 0)
229 return NULL;
230 return PySequence_GetSlice(self->args, start, stop);
233 static PySequenceMethods BaseException_as_sequence = {
234 0, /* sq_length; */
235 0, /* sq_concat; */
236 0, /* sq_repeat; */
237 (ssizeargfunc)BaseException_getitem, /* sq_item; */
238 (ssizessizeargfunc)BaseException_getslice, /* sq_slice; */
239 0, /* sq_ass_item; */
240 0, /* sq_ass_slice; */
241 0, /* sq_contains; */
242 0, /* sq_inplace_concat; */
243 0 /* sq_inplace_repeat; */
246 static PyObject *
247 BaseException_get_dict(PyBaseExceptionObject *self)
249 if (self->dict == NULL) {
250 self->dict = PyDict_New();
251 if (!self->dict)
252 return NULL;
254 Py_INCREF(self->dict);
255 return self->dict;
258 static int
259 BaseException_set_dict(PyBaseExceptionObject *self, PyObject *val)
261 if (val == NULL) {
262 PyErr_SetString(PyExc_TypeError, "__dict__ may not be deleted");
263 return -1;
265 if (!PyDict_Check(val)) {
266 PyErr_SetString(PyExc_TypeError, "__dict__ must be a dictionary");
267 return -1;
269 Py_CLEAR(self->dict);
270 Py_INCREF(val);
271 self->dict = val;
272 return 0;
275 static PyObject *
276 BaseException_get_args(PyBaseExceptionObject *self)
278 if (self->args == NULL) {
279 Py_INCREF(Py_None);
280 return Py_None;
282 Py_INCREF(self->args);
283 return self->args;
286 static int
287 BaseException_set_args(PyBaseExceptionObject *self, PyObject *val)
289 PyObject *seq;
290 if (val == NULL) {
291 PyErr_SetString(PyExc_TypeError, "args may not be deleted");
292 return -1;
294 seq = PySequence_Tuple(val);
295 if (!seq) return -1;
296 Py_CLEAR(self->args);
297 self->args = seq;
298 return 0;
301 static PyObject *
302 BaseException_get_message(PyBaseExceptionObject *self)
304 int ret;
305 ret = PyErr_WarnEx(PyExc_DeprecationWarning,
306 "BaseException.message has been deprecated as "
307 "of Python 2.6", 1);
308 if (ret < 0)
309 return NULL;
311 Py_INCREF(self->message);
312 return self->message;
315 static int
316 BaseException_set_message(PyBaseExceptionObject *self, PyObject *val)
318 int ret;
319 ret = PyErr_WarnEx(PyExc_DeprecationWarning,
320 "BaseException.message has been deprecated as "
321 "of Python 2.6", 1);
322 if (ret < 0)
323 return -1;
324 Py_INCREF(val);
325 Py_DECREF(self->message);
326 self->message = val;
327 return 0;
330 static PyGetSetDef BaseException_getset[] = {
331 {"__dict__", (getter)BaseException_get_dict, (setter)BaseException_set_dict},
332 {"args", (getter)BaseException_get_args, (setter)BaseException_set_args},
333 {"message", (getter)BaseException_get_message,
334 (setter)BaseException_set_message},
335 {NULL},
339 static PyTypeObject _PyExc_BaseException = {
340 PyObject_HEAD_INIT(NULL)
341 0, /*ob_size*/
342 EXC_MODULE_NAME "BaseException", /*tp_name*/
343 sizeof(PyBaseExceptionObject), /*tp_basicsize*/
344 0, /*tp_itemsize*/
345 (destructor)BaseException_dealloc, /*tp_dealloc*/
346 0, /*tp_print*/
347 0, /*tp_getattr*/
348 0, /*tp_setattr*/
349 0, /* tp_compare; */
350 (reprfunc)BaseException_repr, /*tp_repr*/
351 0, /*tp_as_number*/
352 &BaseException_as_sequence, /*tp_as_sequence*/
353 0, /*tp_as_mapping*/
354 0, /*tp_hash */
355 0, /*tp_call*/
356 (reprfunc)BaseException_str, /*tp_str*/
357 PyObject_GenericGetAttr, /*tp_getattro*/
358 PyObject_GenericSetAttr, /*tp_setattro*/
359 0, /*tp_as_buffer*/
360 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC |
361 Py_TPFLAGS_BASE_EXC_SUBCLASS, /*tp_flags*/
362 PyDoc_STR("Common base class for all exceptions"), /* tp_doc */
363 (traverseproc)BaseException_traverse, /* tp_traverse */
364 (inquiry)BaseException_clear, /* tp_clear */
365 0, /* tp_richcompare */
366 0, /* tp_weaklistoffset */
367 0, /* tp_iter */
368 0, /* tp_iternext */
369 BaseException_methods, /* tp_methods */
370 0, /* tp_members */
371 BaseException_getset, /* tp_getset */
372 0, /* tp_base */
373 0, /* tp_dict */
374 0, /* tp_descr_get */
375 0, /* tp_descr_set */
376 offsetof(PyBaseExceptionObject, dict), /* tp_dictoffset */
377 (initproc)BaseException_init, /* tp_init */
378 0, /* tp_alloc */
379 BaseException_new, /* tp_new */
381 /* the CPython API expects exceptions to be (PyObject *) - both a hold-over
382 from the previous implmentation and also allowing Python objects to be used
383 in the API */
384 PyObject *PyExc_BaseException = (PyObject *)&_PyExc_BaseException;
386 /* note these macros omit the last semicolon so the macro invocation may
387 * include it and not look strange.
389 #define SimpleExtendsException(EXCBASE, EXCNAME, EXCDOC) \
390 static PyTypeObject _PyExc_ ## EXCNAME = { \
391 PyObject_HEAD_INIT(NULL) \
392 0, \
393 EXC_MODULE_NAME # EXCNAME, \
394 sizeof(PyBaseExceptionObject), \
395 0, (destructor)BaseException_dealloc, 0, 0, 0, 0, 0, 0, 0, \
396 0, 0, 0, 0, 0, 0, 0, \
397 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC, \
398 PyDoc_STR(EXCDOC), (traverseproc)BaseException_traverse, \
399 (inquiry)BaseException_clear, 0, 0, 0, 0, 0, 0, 0, &_ ## EXCBASE, \
400 0, 0, 0, offsetof(PyBaseExceptionObject, dict), \
401 (initproc)BaseException_init, 0, BaseException_new,\
402 }; \
403 PyObject *PyExc_ ## EXCNAME = (PyObject *)&_PyExc_ ## EXCNAME
405 #define MiddlingExtendsException(EXCBASE, EXCNAME, EXCSTORE, EXCDOC) \
406 static PyTypeObject _PyExc_ ## EXCNAME = { \
407 PyObject_HEAD_INIT(NULL) \
408 0, \
409 EXC_MODULE_NAME # EXCNAME, \
410 sizeof(Py ## EXCSTORE ## Object), \
411 0, (destructor)EXCSTORE ## _dealloc, 0, 0, 0, 0, 0, 0, 0, 0, 0, \
412 0, 0, 0, 0, 0, \
413 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC, \
414 PyDoc_STR(EXCDOC), (traverseproc)EXCSTORE ## _traverse, \
415 (inquiry)EXCSTORE ## _clear, 0, 0, 0, 0, 0, 0, 0, &_ ## EXCBASE, \
416 0, 0, 0, offsetof(Py ## EXCSTORE ## Object, dict), \
417 (initproc)EXCSTORE ## _init, 0, BaseException_new,\
418 }; \
419 PyObject *PyExc_ ## EXCNAME = (PyObject *)&_PyExc_ ## EXCNAME
421 #define ComplexExtendsException(EXCBASE, EXCNAME, EXCSTORE, EXCDEALLOC, EXCMETHODS, EXCMEMBERS, EXCSTR, EXCDOC) \
422 static PyTypeObject _PyExc_ ## EXCNAME = { \
423 PyObject_HEAD_INIT(NULL) \
424 0, \
425 EXC_MODULE_NAME # EXCNAME, \
426 sizeof(Py ## EXCSTORE ## Object), 0, \
427 (destructor)EXCSTORE ## _dealloc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, \
428 (reprfunc)EXCSTR, 0, 0, 0, \
429 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC, \
430 PyDoc_STR(EXCDOC), (traverseproc)EXCSTORE ## _traverse, \
431 (inquiry)EXCSTORE ## _clear, 0, 0, 0, 0, EXCMETHODS, \
432 EXCMEMBERS, 0, &_ ## EXCBASE, \
433 0, 0, 0, offsetof(Py ## EXCSTORE ## Object, dict), \
434 (initproc)EXCSTORE ## _init, 0, BaseException_new,\
435 }; \
436 PyObject *PyExc_ ## EXCNAME = (PyObject *)&_PyExc_ ## EXCNAME
440 * Exception extends BaseException
442 SimpleExtendsException(PyExc_BaseException, Exception,
443 "Common base class for all non-exit exceptions.");
447 * StandardError extends Exception
449 SimpleExtendsException(PyExc_Exception, StandardError,
450 "Base class for all standard Python exceptions that do not represent\n"
451 "interpreter exiting.");
455 * TypeError extends StandardError
457 SimpleExtendsException(PyExc_StandardError, TypeError,
458 "Inappropriate argument type.");
462 * StopIteration extends Exception
464 SimpleExtendsException(PyExc_Exception, StopIteration,
465 "Signal the end from iterator.next().");
469 * GeneratorExit extends BaseException
471 SimpleExtendsException(PyExc_BaseException, GeneratorExit,
472 "Request that a generator exit.");
476 * SystemExit extends BaseException
479 static int
480 SystemExit_init(PySystemExitObject *self, PyObject *args, PyObject *kwds)
482 Py_ssize_t size = PyTuple_GET_SIZE(args);
484 if (BaseException_init((PyBaseExceptionObject *)self, args, kwds) == -1)
485 return -1;
487 if (size == 0)
488 return 0;
489 Py_CLEAR(self->code);
490 if (size == 1)
491 self->code = PyTuple_GET_ITEM(args, 0);
492 else if (size > 1)
493 self->code = args;
494 Py_INCREF(self->code);
495 return 0;
498 static int
499 SystemExit_clear(PySystemExitObject *self)
501 Py_CLEAR(self->code);
502 return BaseException_clear((PyBaseExceptionObject *)self);
505 static void
506 SystemExit_dealloc(PySystemExitObject *self)
508 _PyObject_GC_UNTRACK(self);
509 SystemExit_clear(self);
510 Py_TYPE(self)->tp_free((PyObject *)self);
513 static int
514 SystemExit_traverse(PySystemExitObject *self, visitproc visit, void *arg)
516 Py_VISIT(self->code);
517 return BaseException_traverse((PyBaseExceptionObject *)self, visit, arg);
520 static PyMemberDef SystemExit_members[] = {
521 {"code", T_OBJECT, offsetof(PySystemExitObject, code), 0,
522 PyDoc_STR("exception code")},
523 {NULL} /* Sentinel */
526 ComplexExtendsException(PyExc_BaseException, SystemExit, SystemExit,
527 SystemExit_dealloc, 0, SystemExit_members, 0,
528 "Request to exit from the interpreter.");
531 * KeyboardInterrupt extends BaseException
533 SimpleExtendsException(PyExc_BaseException, KeyboardInterrupt,
534 "Program interrupted by user.");
538 * ImportError extends StandardError
540 SimpleExtendsException(PyExc_StandardError, ImportError,
541 "Import can't find module, or can't find name in module.");
545 * EnvironmentError extends StandardError
548 /* Where a function has a single filename, such as open() or some
549 * of the os module functions, PyErr_SetFromErrnoWithFilename() is
550 * called, giving a third argument which is the filename. But, so
551 * that old code using in-place unpacking doesn't break, e.g.:
553 * except IOError, (errno, strerror):
555 * we hack args so that it only contains two items. This also
556 * means we need our own __str__() which prints out the filename
557 * when it was supplied.
559 static int
560 EnvironmentError_init(PyEnvironmentErrorObject *self, PyObject *args,
561 PyObject *kwds)
563 PyObject *myerrno = NULL, *strerror = NULL, *filename = NULL;
564 PyObject *subslice = NULL;
566 if (BaseException_init((PyBaseExceptionObject *)self, args, kwds) == -1)
567 return -1;
569 if (PyTuple_GET_SIZE(args) <= 1 || PyTuple_GET_SIZE(args) > 3) {
570 return 0;
573 if (!PyArg_UnpackTuple(args, "EnvironmentError", 2, 3,
574 &myerrno, &strerror, &filename)) {
575 return -1;
577 Py_CLEAR(self->myerrno); /* replacing */
578 self->myerrno = myerrno;
579 Py_INCREF(self->myerrno);
581 Py_CLEAR(self->strerror); /* replacing */
582 self->strerror = strerror;
583 Py_INCREF(self->strerror);
585 /* self->filename will remain Py_None otherwise */
586 if (filename != NULL) {
587 Py_CLEAR(self->filename); /* replacing */
588 self->filename = filename;
589 Py_INCREF(self->filename);
591 subslice = PyTuple_GetSlice(args, 0, 2);
592 if (!subslice)
593 return -1;
595 Py_DECREF(self->args); /* replacing args */
596 self->args = subslice;
598 return 0;
601 static int
602 EnvironmentError_clear(PyEnvironmentErrorObject *self)
604 Py_CLEAR(self->myerrno);
605 Py_CLEAR(self->strerror);
606 Py_CLEAR(self->filename);
607 return BaseException_clear((PyBaseExceptionObject *)self);
610 static void
611 EnvironmentError_dealloc(PyEnvironmentErrorObject *self)
613 _PyObject_GC_UNTRACK(self);
614 EnvironmentError_clear(self);
615 Py_TYPE(self)->tp_free((PyObject *)self);
618 static int
619 EnvironmentError_traverse(PyEnvironmentErrorObject *self, visitproc visit,
620 void *arg)
622 Py_VISIT(self->myerrno);
623 Py_VISIT(self->strerror);
624 Py_VISIT(self->filename);
625 return BaseException_traverse((PyBaseExceptionObject *)self, visit, arg);
628 static PyObject *
629 EnvironmentError_str(PyEnvironmentErrorObject *self)
631 PyObject *rtnval = NULL;
633 if (self->filename) {
634 PyObject *fmt;
635 PyObject *repr;
636 PyObject *tuple;
638 fmt = PyString_FromString("[Errno %s] %s: %s");
639 if (!fmt)
640 return NULL;
642 repr = PyObject_Repr(self->filename);
643 if (!repr) {
644 Py_DECREF(fmt);
645 return NULL;
647 tuple = PyTuple_New(3);
648 if (!tuple) {
649 Py_DECREF(repr);
650 Py_DECREF(fmt);
651 return NULL;
654 if (self->myerrno) {
655 Py_INCREF(self->myerrno);
656 PyTuple_SET_ITEM(tuple, 0, self->myerrno);
658 else {
659 Py_INCREF(Py_None);
660 PyTuple_SET_ITEM(tuple, 0, Py_None);
662 if (self->strerror) {
663 Py_INCREF(self->strerror);
664 PyTuple_SET_ITEM(tuple, 1, self->strerror);
666 else {
667 Py_INCREF(Py_None);
668 PyTuple_SET_ITEM(tuple, 1, Py_None);
671 PyTuple_SET_ITEM(tuple, 2, repr);
673 rtnval = PyString_Format(fmt, tuple);
675 Py_DECREF(fmt);
676 Py_DECREF(tuple);
678 else if (self->myerrno && self->strerror) {
679 PyObject *fmt;
680 PyObject *tuple;
682 fmt = PyString_FromString("[Errno %s] %s");
683 if (!fmt)
684 return NULL;
686 tuple = PyTuple_New(2);
687 if (!tuple) {
688 Py_DECREF(fmt);
689 return NULL;
692 if (self->myerrno) {
693 Py_INCREF(self->myerrno);
694 PyTuple_SET_ITEM(tuple, 0, self->myerrno);
696 else {
697 Py_INCREF(Py_None);
698 PyTuple_SET_ITEM(tuple, 0, Py_None);
700 if (self->strerror) {
701 Py_INCREF(self->strerror);
702 PyTuple_SET_ITEM(tuple, 1, self->strerror);
704 else {
705 Py_INCREF(Py_None);
706 PyTuple_SET_ITEM(tuple, 1, Py_None);
709 rtnval = PyString_Format(fmt, tuple);
711 Py_DECREF(fmt);
712 Py_DECREF(tuple);
714 else
715 rtnval = BaseException_str((PyBaseExceptionObject *)self);
717 return rtnval;
720 static PyMemberDef EnvironmentError_members[] = {
721 {"errno", T_OBJECT, offsetof(PyEnvironmentErrorObject, myerrno), 0,
722 PyDoc_STR("exception errno")},
723 {"strerror", T_OBJECT, offsetof(PyEnvironmentErrorObject, strerror), 0,
724 PyDoc_STR("exception strerror")},
725 {"filename", T_OBJECT, offsetof(PyEnvironmentErrorObject, filename), 0,
726 PyDoc_STR("exception filename")},
727 {NULL} /* Sentinel */
731 static PyObject *
732 EnvironmentError_reduce(PyEnvironmentErrorObject *self)
734 PyObject *args = self->args;
735 PyObject *res = NULL, *tmp;
737 /* self->args is only the first two real arguments if there was a
738 * file name given to EnvironmentError. */
739 if (PyTuple_GET_SIZE(args) == 2 && self->filename) {
740 args = PyTuple_New(3);
741 if (!args) return NULL;
743 tmp = PyTuple_GET_ITEM(self->args, 0);
744 Py_INCREF(tmp);
745 PyTuple_SET_ITEM(args, 0, tmp);
747 tmp = PyTuple_GET_ITEM(self->args, 1);
748 Py_INCREF(tmp);
749 PyTuple_SET_ITEM(args, 1, tmp);
751 Py_INCREF(self->filename);
752 PyTuple_SET_ITEM(args, 2, self->filename);
753 } else
754 Py_INCREF(args);
756 if (self->dict)
757 res = PyTuple_Pack(3, Py_TYPE(self), args, self->dict);
758 else
759 res = PyTuple_Pack(2, Py_TYPE(self), args);
760 Py_DECREF(args);
761 return res;
765 static PyMethodDef EnvironmentError_methods[] = {
766 {"__reduce__", (PyCFunction)EnvironmentError_reduce, METH_NOARGS},
767 {NULL}
770 ComplexExtendsException(PyExc_StandardError, EnvironmentError,
771 EnvironmentError, EnvironmentError_dealloc,
772 EnvironmentError_methods, EnvironmentError_members,
773 EnvironmentError_str,
774 "Base class for I/O related errors.");
778 * IOError extends EnvironmentError
780 MiddlingExtendsException(PyExc_EnvironmentError, IOError,
781 EnvironmentError, "I/O operation failed.");
785 * OSError extends EnvironmentError
787 MiddlingExtendsException(PyExc_EnvironmentError, OSError,
788 EnvironmentError, "OS system call failed.");
792 * WindowsError extends OSError
794 #ifdef MS_WINDOWS
795 #include "errmap.h"
797 static int
798 WindowsError_clear(PyWindowsErrorObject *self)
800 Py_CLEAR(self->myerrno);
801 Py_CLEAR(self->strerror);
802 Py_CLEAR(self->filename);
803 Py_CLEAR(self->winerror);
804 return BaseException_clear((PyBaseExceptionObject *)self);
807 static void
808 WindowsError_dealloc(PyWindowsErrorObject *self)
810 _PyObject_GC_UNTRACK(self);
811 WindowsError_clear(self);
812 Py_TYPE(self)->tp_free((PyObject *)self);
815 static int
816 WindowsError_traverse(PyWindowsErrorObject *self, visitproc visit, void *arg)
818 Py_VISIT(self->myerrno);
819 Py_VISIT(self->strerror);
820 Py_VISIT(self->filename);
821 Py_VISIT(self->winerror);
822 return BaseException_traverse((PyBaseExceptionObject *)self, visit, arg);
825 static int
826 WindowsError_init(PyWindowsErrorObject *self, PyObject *args, PyObject *kwds)
828 PyObject *o_errcode = NULL;
829 long errcode;
830 long posix_errno;
832 if (EnvironmentError_init((PyEnvironmentErrorObject *)self, args, kwds)
833 == -1)
834 return -1;
836 if (self->myerrno == NULL)
837 return 0;
839 /* Set errno to the POSIX errno, and winerror to the Win32
840 error code. */
841 errcode = PyInt_AsLong(self->myerrno);
842 if (errcode == -1 && PyErr_Occurred())
843 return -1;
844 posix_errno = winerror_to_errno(errcode);
846 Py_CLEAR(self->winerror);
847 self->winerror = self->myerrno;
849 o_errcode = PyInt_FromLong(posix_errno);
850 if (!o_errcode)
851 return -1;
853 self->myerrno = o_errcode;
855 return 0;
859 static PyObject *
860 WindowsError_str(PyWindowsErrorObject *self)
862 PyObject *rtnval = NULL;
864 if (self->filename) {
865 PyObject *fmt;
866 PyObject *repr;
867 PyObject *tuple;
869 fmt = PyString_FromString("[Error %s] %s: %s");
870 if (!fmt)
871 return NULL;
873 repr = PyObject_Repr(self->filename);
874 if (!repr) {
875 Py_DECREF(fmt);
876 return NULL;
878 tuple = PyTuple_New(3);
879 if (!tuple) {
880 Py_DECREF(repr);
881 Py_DECREF(fmt);
882 return NULL;
885 if (self->winerror) {
886 Py_INCREF(self->winerror);
887 PyTuple_SET_ITEM(tuple, 0, self->winerror);
889 else {
890 Py_INCREF(Py_None);
891 PyTuple_SET_ITEM(tuple, 0, Py_None);
893 if (self->strerror) {
894 Py_INCREF(self->strerror);
895 PyTuple_SET_ITEM(tuple, 1, self->strerror);
897 else {
898 Py_INCREF(Py_None);
899 PyTuple_SET_ITEM(tuple, 1, Py_None);
902 PyTuple_SET_ITEM(tuple, 2, repr);
904 rtnval = PyString_Format(fmt, tuple);
906 Py_DECREF(fmt);
907 Py_DECREF(tuple);
909 else if (self->winerror && self->strerror) {
910 PyObject *fmt;
911 PyObject *tuple;
913 fmt = PyString_FromString("[Error %s] %s");
914 if (!fmt)
915 return NULL;
917 tuple = PyTuple_New(2);
918 if (!tuple) {
919 Py_DECREF(fmt);
920 return NULL;
923 if (self->winerror) {
924 Py_INCREF(self->winerror);
925 PyTuple_SET_ITEM(tuple, 0, self->winerror);
927 else {
928 Py_INCREF(Py_None);
929 PyTuple_SET_ITEM(tuple, 0, Py_None);
931 if (self->strerror) {
932 Py_INCREF(self->strerror);
933 PyTuple_SET_ITEM(tuple, 1, self->strerror);
935 else {
936 Py_INCREF(Py_None);
937 PyTuple_SET_ITEM(tuple, 1, Py_None);
940 rtnval = PyString_Format(fmt, tuple);
942 Py_DECREF(fmt);
943 Py_DECREF(tuple);
945 else
946 rtnval = EnvironmentError_str((PyEnvironmentErrorObject *)self);
948 return rtnval;
951 static PyMemberDef WindowsError_members[] = {
952 {"errno", T_OBJECT, offsetof(PyWindowsErrorObject, myerrno), 0,
953 PyDoc_STR("POSIX exception code")},
954 {"strerror", T_OBJECT, offsetof(PyWindowsErrorObject, strerror), 0,
955 PyDoc_STR("exception strerror")},
956 {"filename", T_OBJECT, offsetof(PyWindowsErrorObject, filename), 0,
957 PyDoc_STR("exception filename")},
958 {"winerror", T_OBJECT, offsetof(PyWindowsErrorObject, winerror), 0,
959 PyDoc_STR("Win32 exception code")},
960 {NULL} /* Sentinel */
963 ComplexExtendsException(PyExc_OSError, WindowsError, WindowsError,
964 WindowsError_dealloc, 0, WindowsError_members,
965 WindowsError_str, "MS-Windows OS system call failed.");
967 #endif /* MS_WINDOWS */
971 * VMSError extends OSError (I think)
973 #ifdef __VMS
974 MiddlingExtendsException(PyExc_OSError, VMSError, EnvironmentError,
975 "OpenVMS OS system call failed.");
976 #endif
980 * EOFError extends StandardError
982 SimpleExtendsException(PyExc_StandardError, EOFError,
983 "Read beyond end of file.");
987 * RuntimeError extends StandardError
989 SimpleExtendsException(PyExc_StandardError, RuntimeError,
990 "Unspecified run-time error.");
994 * NotImplementedError extends RuntimeError
996 SimpleExtendsException(PyExc_RuntimeError, NotImplementedError,
997 "Method or function hasn't been implemented yet.");
1000 * NameError extends StandardError
1002 SimpleExtendsException(PyExc_StandardError, NameError,
1003 "Name not found globally.");
1006 * UnboundLocalError extends NameError
1008 SimpleExtendsException(PyExc_NameError, UnboundLocalError,
1009 "Local name referenced but not bound to a value.");
1012 * AttributeError extends StandardError
1014 SimpleExtendsException(PyExc_StandardError, AttributeError,
1015 "Attribute not found.");
1019 * SyntaxError extends StandardError
1022 static int
1023 SyntaxError_init(PySyntaxErrorObject *self, PyObject *args, PyObject *kwds)
1025 PyObject *info = NULL;
1026 Py_ssize_t lenargs = PyTuple_GET_SIZE(args);
1028 if (BaseException_init((PyBaseExceptionObject *)self, args, kwds) == -1)
1029 return -1;
1031 if (lenargs >= 1) {
1032 Py_CLEAR(self->msg);
1033 self->msg = PyTuple_GET_ITEM(args, 0);
1034 Py_INCREF(self->msg);
1036 if (lenargs == 2) {
1037 info = PyTuple_GET_ITEM(args, 1);
1038 info = PySequence_Tuple(info);
1039 if (!info) return -1;
1041 if (PyTuple_GET_SIZE(info) != 4) {
1042 /* not a very good error message, but it's what Python 2.4 gives */
1043 PyErr_SetString(PyExc_IndexError, "tuple index out of range");
1044 Py_DECREF(info);
1045 return -1;
1048 Py_CLEAR(self->filename);
1049 self->filename = PyTuple_GET_ITEM(info, 0);
1050 Py_INCREF(self->filename);
1052 Py_CLEAR(self->lineno);
1053 self->lineno = PyTuple_GET_ITEM(info, 1);
1054 Py_INCREF(self->lineno);
1056 Py_CLEAR(self->offset);
1057 self->offset = PyTuple_GET_ITEM(info, 2);
1058 Py_INCREF(self->offset);
1060 Py_CLEAR(self->text);
1061 self->text = PyTuple_GET_ITEM(info, 3);
1062 Py_INCREF(self->text);
1064 Py_DECREF(info);
1066 return 0;
1069 static int
1070 SyntaxError_clear(PySyntaxErrorObject *self)
1072 Py_CLEAR(self->msg);
1073 Py_CLEAR(self->filename);
1074 Py_CLEAR(self->lineno);
1075 Py_CLEAR(self->offset);
1076 Py_CLEAR(self->text);
1077 Py_CLEAR(self->print_file_and_line);
1078 return BaseException_clear((PyBaseExceptionObject *)self);
1081 static void
1082 SyntaxError_dealloc(PySyntaxErrorObject *self)
1084 _PyObject_GC_UNTRACK(self);
1085 SyntaxError_clear(self);
1086 Py_TYPE(self)->tp_free((PyObject *)self);
1089 static int
1090 SyntaxError_traverse(PySyntaxErrorObject *self, visitproc visit, void *arg)
1092 Py_VISIT(self->msg);
1093 Py_VISIT(self->filename);
1094 Py_VISIT(self->lineno);
1095 Py_VISIT(self->offset);
1096 Py_VISIT(self->text);
1097 Py_VISIT(self->print_file_and_line);
1098 return BaseException_traverse((PyBaseExceptionObject *)self, visit, arg);
1101 /* This is called "my_basename" instead of just "basename" to avoid name
1102 conflicts with glibc; basename is already prototyped if _GNU_SOURCE is
1103 defined, and Python does define that. */
1104 static char *
1105 my_basename(char *name)
1107 char *cp = name;
1108 char *result = name;
1110 if (name == NULL)
1111 return "???";
1112 while (*cp != '\0') {
1113 if (*cp == SEP)
1114 result = cp + 1;
1115 ++cp;
1117 return result;
1121 static PyObject *
1122 SyntaxError_str(PySyntaxErrorObject *self)
1124 PyObject *str;
1125 PyObject *result;
1126 int have_filename = 0;
1127 int have_lineno = 0;
1128 char *buffer = NULL;
1129 Py_ssize_t bufsize;
1131 if (self->msg)
1132 str = PyObject_Str(self->msg);
1133 else
1134 str = PyObject_Str(Py_None);
1135 if (!str) return NULL;
1136 /* Don't fiddle with non-string return (shouldn't happen anyway) */
1137 if (!PyString_Check(str)) return str;
1139 /* XXX -- do all the additional formatting with filename and
1140 lineno here */
1142 have_filename = (self->filename != NULL) &&
1143 PyString_Check(self->filename);
1144 have_lineno = (self->lineno != NULL) && PyInt_Check(self->lineno);
1146 if (!have_filename && !have_lineno)
1147 return str;
1149 bufsize = PyString_GET_SIZE(str) + 64;
1150 if (have_filename)
1151 bufsize += PyString_GET_SIZE(self->filename);
1153 buffer = PyMem_MALLOC(bufsize);
1154 if (buffer == NULL)
1155 return str;
1157 if (have_filename && have_lineno)
1158 PyOS_snprintf(buffer, bufsize, "%s (%s, line %ld)",
1159 PyString_AS_STRING(str),
1160 my_basename(PyString_AS_STRING(self->filename)),
1161 PyInt_AsLong(self->lineno));
1162 else if (have_filename)
1163 PyOS_snprintf(buffer, bufsize, "%s (%s)",
1164 PyString_AS_STRING(str),
1165 my_basename(PyString_AS_STRING(self->filename)));
1166 else /* only have_lineno */
1167 PyOS_snprintf(buffer, bufsize, "%s (line %ld)",
1168 PyString_AS_STRING(str),
1169 PyInt_AsLong(self->lineno));
1171 result = PyString_FromString(buffer);
1172 PyMem_FREE(buffer);
1174 if (result == NULL)
1175 result = str;
1176 else
1177 Py_DECREF(str);
1178 return result;
1181 static PyMemberDef SyntaxError_members[] = {
1182 {"msg", T_OBJECT, offsetof(PySyntaxErrorObject, msg), 0,
1183 PyDoc_STR("exception msg")},
1184 {"filename", T_OBJECT, offsetof(PySyntaxErrorObject, filename), 0,
1185 PyDoc_STR("exception filename")},
1186 {"lineno", T_OBJECT, offsetof(PySyntaxErrorObject, lineno), 0,
1187 PyDoc_STR("exception lineno")},
1188 {"offset", T_OBJECT, offsetof(PySyntaxErrorObject, offset), 0,
1189 PyDoc_STR("exception offset")},
1190 {"text", T_OBJECT, offsetof(PySyntaxErrorObject, text), 0,
1191 PyDoc_STR("exception text")},
1192 {"print_file_and_line", T_OBJECT,
1193 offsetof(PySyntaxErrorObject, print_file_and_line), 0,
1194 PyDoc_STR("exception print_file_and_line")},
1195 {NULL} /* Sentinel */
1198 ComplexExtendsException(PyExc_StandardError, SyntaxError, SyntaxError,
1199 SyntaxError_dealloc, 0, SyntaxError_members,
1200 SyntaxError_str, "Invalid syntax.");
1204 * IndentationError extends SyntaxError
1206 MiddlingExtendsException(PyExc_SyntaxError, IndentationError, SyntaxError,
1207 "Improper indentation.");
1211 * TabError extends IndentationError
1213 MiddlingExtendsException(PyExc_IndentationError, TabError, SyntaxError,
1214 "Improper mixture of spaces and tabs.");
1218 * LookupError extends StandardError
1220 SimpleExtendsException(PyExc_StandardError, LookupError,
1221 "Base class for lookup errors.");
1225 * IndexError extends LookupError
1227 SimpleExtendsException(PyExc_LookupError, IndexError,
1228 "Sequence index out of range.");
1232 * KeyError extends LookupError
1234 static PyObject *
1235 KeyError_str(PyBaseExceptionObject *self)
1237 /* If args is a tuple of exactly one item, apply repr to args[0].
1238 This is done so that e.g. the exception raised by {}[''] prints
1239 KeyError: ''
1240 rather than the confusing
1241 KeyError
1242 alone. The downside is that if KeyError is raised with an explanatory
1243 string, that string will be displayed in quotes. Too bad.
1244 If args is anything else, use the default BaseException__str__().
1246 if (PyTuple_GET_SIZE(self->args) == 1) {
1247 return PyObject_Repr(PyTuple_GET_ITEM(self->args, 0));
1249 return BaseException_str(self);
1252 ComplexExtendsException(PyExc_LookupError, KeyError, BaseException,
1253 0, 0, 0, KeyError_str, "Mapping key not found.");
1257 * ValueError extends StandardError
1259 SimpleExtendsException(PyExc_StandardError, ValueError,
1260 "Inappropriate argument value (of correct type).");
1263 * UnicodeError extends ValueError
1266 SimpleExtendsException(PyExc_ValueError, UnicodeError,
1267 "Unicode related error.");
1269 #ifdef Py_USING_UNICODE
1270 static PyObject *
1271 get_string(PyObject *attr, const char *name)
1273 if (!attr) {
1274 PyErr_Format(PyExc_TypeError, "%.200s attribute not set", name);
1275 return NULL;
1278 if (!PyString_Check(attr)) {
1279 PyErr_Format(PyExc_TypeError, "%.200s attribute must be str", name);
1280 return NULL;
1282 Py_INCREF(attr);
1283 return attr;
1287 static int
1288 set_string(PyObject **attr, const char *value)
1290 PyObject *obj = PyString_FromString(value);
1291 if (!obj)
1292 return -1;
1293 Py_CLEAR(*attr);
1294 *attr = obj;
1295 return 0;
1299 static PyObject *
1300 get_unicode(PyObject *attr, const char *name)
1302 if (!attr) {
1303 PyErr_Format(PyExc_TypeError, "%.200s attribute not set", name);
1304 return NULL;
1307 if (!PyUnicode_Check(attr)) {
1308 PyErr_Format(PyExc_TypeError,
1309 "%.200s attribute must be unicode", name);
1310 return NULL;
1312 Py_INCREF(attr);
1313 return attr;
1316 PyObject *
1317 PyUnicodeEncodeError_GetEncoding(PyObject *exc)
1319 return get_string(((PyUnicodeErrorObject *)exc)->encoding, "encoding");
1322 PyObject *
1323 PyUnicodeDecodeError_GetEncoding(PyObject *exc)
1325 return get_string(((PyUnicodeErrorObject *)exc)->encoding, "encoding");
1328 PyObject *
1329 PyUnicodeEncodeError_GetObject(PyObject *exc)
1331 return get_unicode(((PyUnicodeErrorObject *)exc)->object, "object");
1334 PyObject *
1335 PyUnicodeDecodeError_GetObject(PyObject *exc)
1337 return get_string(((PyUnicodeErrorObject *)exc)->object, "object");
1340 PyObject *
1341 PyUnicodeTranslateError_GetObject(PyObject *exc)
1343 return get_unicode(((PyUnicodeErrorObject *)exc)->object, "object");
1347 PyUnicodeEncodeError_GetStart(PyObject *exc, Py_ssize_t *start)
1349 Py_ssize_t size;
1350 PyObject *obj = get_unicode(((PyUnicodeErrorObject *)exc)->object,
1351 "object");
1352 if (!obj)
1353 return -1;
1354 *start = ((PyUnicodeErrorObject *)exc)->start;
1355 size = PyUnicode_GET_SIZE(obj);
1356 if (*start<0)
1357 *start = 0; /*XXX check for values <0*/
1358 if (*start>=size)
1359 *start = size-1;
1360 Py_DECREF(obj);
1361 return 0;
1366 PyUnicodeDecodeError_GetStart(PyObject *exc, Py_ssize_t *start)
1368 Py_ssize_t size;
1369 PyObject *obj = get_string(((PyUnicodeErrorObject *)exc)->object,
1370 "object");
1371 if (!obj)
1372 return -1;
1373 size = PyString_GET_SIZE(obj);
1374 *start = ((PyUnicodeErrorObject *)exc)->start;
1375 if (*start<0)
1376 *start = 0;
1377 if (*start>=size)
1378 *start = size-1;
1379 Py_DECREF(obj);
1380 return 0;
1385 PyUnicodeTranslateError_GetStart(PyObject *exc, Py_ssize_t *start)
1387 return PyUnicodeEncodeError_GetStart(exc, start);
1392 PyUnicodeEncodeError_SetStart(PyObject *exc, Py_ssize_t start)
1394 ((PyUnicodeErrorObject *)exc)->start = start;
1395 return 0;
1400 PyUnicodeDecodeError_SetStart(PyObject *exc, Py_ssize_t start)
1402 ((PyUnicodeErrorObject *)exc)->start = start;
1403 return 0;
1408 PyUnicodeTranslateError_SetStart(PyObject *exc, Py_ssize_t start)
1410 ((PyUnicodeErrorObject *)exc)->start = start;
1411 return 0;
1416 PyUnicodeEncodeError_GetEnd(PyObject *exc, Py_ssize_t *end)
1418 Py_ssize_t size;
1419 PyObject *obj = get_unicode(((PyUnicodeErrorObject *)exc)->object,
1420 "object");
1421 if (!obj)
1422 return -1;
1423 *end = ((PyUnicodeErrorObject *)exc)->end;
1424 size = PyUnicode_GET_SIZE(obj);
1425 if (*end<1)
1426 *end = 1;
1427 if (*end>size)
1428 *end = size;
1429 Py_DECREF(obj);
1430 return 0;
1435 PyUnicodeDecodeError_GetEnd(PyObject *exc, Py_ssize_t *end)
1437 Py_ssize_t size;
1438 PyObject *obj = get_string(((PyUnicodeErrorObject *)exc)->object,
1439 "object");
1440 if (!obj)
1441 return -1;
1442 *end = ((PyUnicodeErrorObject *)exc)->end;
1443 size = PyString_GET_SIZE(obj);
1444 if (*end<1)
1445 *end = 1;
1446 if (*end>size)
1447 *end = size;
1448 Py_DECREF(obj);
1449 return 0;
1454 PyUnicodeTranslateError_GetEnd(PyObject *exc, Py_ssize_t *start)
1456 return PyUnicodeEncodeError_GetEnd(exc, start);
1461 PyUnicodeEncodeError_SetEnd(PyObject *exc, Py_ssize_t end)
1463 ((PyUnicodeErrorObject *)exc)->end = end;
1464 return 0;
1469 PyUnicodeDecodeError_SetEnd(PyObject *exc, Py_ssize_t end)
1471 ((PyUnicodeErrorObject *)exc)->end = end;
1472 return 0;
1477 PyUnicodeTranslateError_SetEnd(PyObject *exc, Py_ssize_t end)
1479 ((PyUnicodeErrorObject *)exc)->end = end;
1480 return 0;
1483 PyObject *
1484 PyUnicodeEncodeError_GetReason(PyObject *exc)
1486 return get_string(((PyUnicodeErrorObject *)exc)->reason, "reason");
1490 PyObject *
1491 PyUnicodeDecodeError_GetReason(PyObject *exc)
1493 return get_string(((PyUnicodeErrorObject *)exc)->reason, "reason");
1497 PyObject *
1498 PyUnicodeTranslateError_GetReason(PyObject *exc)
1500 return get_string(((PyUnicodeErrorObject *)exc)->reason, "reason");
1505 PyUnicodeEncodeError_SetReason(PyObject *exc, const char *reason)
1507 return set_string(&((PyUnicodeErrorObject *)exc)->reason, reason);
1512 PyUnicodeDecodeError_SetReason(PyObject *exc, const char *reason)
1514 return set_string(&((PyUnicodeErrorObject *)exc)->reason, reason);
1519 PyUnicodeTranslateError_SetReason(PyObject *exc, const char *reason)
1521 return set_string(&((PyUnicodeErrorObject *)exc)->reason, reason);
1525 static int
1526 UnicodeError_init(PyUnicodeErrorObject *self, PyObject *args, PyObject *kwds,
1527 PyTypeObject *objecttype)
1529 Py_CLEAR(self->encoding);
1530 Py_CLEAR(self->object);
1531 Py_CLEAR(self->reason);
1533 if (!PyArg_ParseTuple(args, "O!O!nnO!",
1534 &PyString_Type, &self->encoding,
1535 objecttype, &self->object,
1536 &self->start,
1537 &self->end,
1538 &PyString_Type, &self->reason)) {
1539 self->encoding = self->object = self->reason = NULL;
1540 return -1;
1543 Py_INCREF(self->encoding);
1544 Py_INCREF(self->object);
1545 Py_INCREF(self->reason);
1547 return 0;
1550 static int
1551 UnicodeError_clear(PyUnicodeErrorObject *self)
1553 Py_CLEAR(self->encoding);
1554 Py_CLEAR(self->object);
1555 Py_CLEAR(self->reason);
1556 return BaseException_clear((PyBaseExceptionObject *)self);
1559 static void
1560 UnicodeError_dealloc(PyUnicodeErrorObject *self)
1562 _PyObject_GC_UNTRACK(self);
1563 UnicodeError_clear(self);
1564 Py_TYPE(self)->tp_free((PyObject *)self);
1567 static int
1568 UnicodeError_traverse(PyUnicodeErrorObject *self, visitproc visit, void *arg)
1570 Py_VISIT(self->encoding);
1571 Py_VISIT(self->object);
1572 Py_VISIT(self->reason);
1573 return BaseException_traverse((PyBaseExceptionObject *)self, visit, arg);
1576 static PyMemberDef UnicodeError_members[] = {
1577 {"encoding", T_OBJECT, offsetof(PyUnicodeErrorObject, encoding), 0,
1578 PyDoc_STR("exception encoding")},
1579 {"object", T_OBJECT, offsetof(PyUnicodeErrorObject, object), 0,
1580 PyDoc_STR("exception object")},
1581 {"start", T_PYSSIZET, offsetof(PyUnicodeErrorObject, start), 0,
1582 PyDoc_STR("exception start")},
1583 {"end", T_PYSSIZET, offsetof(PyUnicodeErrorObject, end), 0,
1584 PyDoc_STR("exception end")},
1585 {"reason", T_OBJECT, offsetof(PyUnicodeErrorObject, reason), 0,
1586 PyDoc_STR("exception reason")},
1587 {NULL} /* Sentinel */
1592 * UnicodeEncodeError extends UnicodeError
1595 static int
1596 UnicodeEncodeError_init(PyObject *self, PyObject *args, PyObject *kwds)
1598 if (BaseException_init((PyBaseExceptionObject *)self, args, kwds) == -1)
1599 return -1;
1600 return UnicodeError_init((PyUnicodeErrorObject *)self, args,
1601 kwds, &PyUnicode_Type);
1604 static PyObject *
1605 UnicodeEncodeError_str(PyObject *self)
1607 PyUnicodeErrorObject *uself = (PyUnicodeErrorObject *)self;
1609 if (uself->end==uself->start+1) {
1610 int badchar = (int)PyUnicode_AS_UNICODE(uself->object)[uself->start];
1611 char badchar_str[20];
1612 if (badchar <= 0xff)
1613 PyOS_snprintf(badchar_str, sizeof(badchar_str), "x%02x", badchar);
1614 else if (badchar <= 0xffff)
1615 PyOS_snprintf(badchar_str, sizeof(badchar_str), "u%04x", badchar);
1616 else
1617 PyOS_snprintf(badchar_str, sizeof(badchar_str), "U%08x", badchar);
1618 return PyString_FromFormat(
1619 "'%.400s' codec can't encode character u'\\%s' in position %zd: %.400s",
1620 PyString_AS_STRING(uself->encoding),
1621 badchar_str,
1622 uself->start,
1623 PyString_AS_STRING(uself->reason)
1626 return PyString_FromFormat(
1627 "'%.400s' codec can't encode characters in position %zd-%zd: %.400s",
1628 PyString_AS_STRING(uself->encoding),
1629 uself->start,
1630 uself->end-1,
1631 PyString_AS_STRING(uself->reason)
1635 static PyTypeObject _PyExc_UnicodeEncodeError = {
1636 PyObject_HEAD_INIT(NULL)
1638 EXC_MODULE_NAME "UnicodeEncodeError",
1639 sizeof(PyUnicodeErrorObject), 0,
1640 (destructor)UnicodeError_dealloc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
1641 (reprfunc)UnicodeEncodeError_str, 0, 0, 0,
1642 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC,
1643 PyDoc_STR("Unicode encoding error."), (traverseproc)UnicodeError_traverse,
1644 (inquiry)UnicodeError_clear, 0, 0, 0, 0, 0, UnicodeError_members,
1645 0, &_PyExc_UnicodeError, 0, 0, 0, offsetof(PyUnicodeErrorObject, dict),
1646 (initproc)UnicodeEncodeError_init, 0, BaseException_new,
1648 PyObject *PyExc_UnicodeEncodeError = (PyObject *)&_PyExc_UnicodeEncodeError;
1650 PyObject *
1651 PyUnicodeEncodeError_Create(
1652 const char *encoding, const Py_UNICODE *object, Py_ssize_t length,
1653 Py_ssize_t start, Py_ssize_t end, const char *reason)
1655 return PyObject_CallFunction(PyExc_UnicodeEncodeError, "su#nns",
1656 encoding, object, length, start, end, reason);
1661 * UnicodeDecodeError extends UnicodeError
1664 static int
1665 UnicodeDecodeError_init(PyObject *self, PyObject *args, PyObject *kwds)
1667 if (BaseException_init((PyBaseExceptionObject *)self, args, kwds) == -1)
1668 return -1;
1669 return UnicodeError_init((PyUnicodeErrorObject *)self, args,
1670 kwds, &PyString_Type);
1673 static PyObject *
1674 UnicodeDecodeError_str(PyObject *self)
1676 PyUnicodeErrorObject *uself = (PyUnicodeErrorObject *)self;
1678 if (uself->end==uself->start+1) {
1679 /* FromFormat does not support %02x, so format that separately */
1680 char byte[4];
1681 PyOS_snprintf(byte, sizeof(byte), "%02x",
1682 ((int)PyString_AS_STRING(uself->object)[uself->start])&0xff);
1683 return PyString_FromFormat(
1684 "'%.400s' codec can't decode byte 0x%s in position %zd: %.400s",
1685 PyString_AS_STRING(uself->encoding),
1686 byte,
1687 uself->start,
1688 PyString_AS_STRING(uself->reason)
1691 return PyString_FromFormat(
1692 "'%.400s' codec can't decode bytes in position %zd-%zd: %.400s",
1693 PyString_AS_STRING(uself->encoding),
1694 uself->start,
1695 uself->end-1,
1696 PyString_AS_STRING(uself->reason)
1700 static PyTypeObject _PyExc_UnicodeDecodeError = {
1701 PyObject_HEAD_INIT(NULL)
1703 EXC_MODULE_NAME "UnicodeDecodeError",
1704 sizeof(PyUnicodeErrorObject), 0,
1705 (destructor)UnicodeError_dealloc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
1706 (reprfunc)UnicodeDecodeError_str, 0, 0, 0,
1707 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC,
1708 PyDoc_STR("Unicode decoding error."), (traverseproc)UnicodeError_traverse,
1709 (inquiry)UnicodeError_clear, 0, 0, 0, 0, 0, UnicodeError_members,
1710 0, &_PyExc_UnicodeError, 0, 0, 0, offsetof(PyUnicodeErrorObject, dict),
1711 (initproc)UnicodeDecodeError_init, 0, BaseException_new,
1713 PyObject *PyExc_UnicodeDecodeError = (PyObject *)&_PyExc_UnicodeDecodeError;
1715 PyObject *
1716 PyUnicodeDecodeError_Create(
1717 const char *encoding, const char *object, Py_ssize_t length,
1718 Py_ssize_t start, Py_ssize_t end, const char *reason)
1720 assert(length < INT_MAX);
1721 assert(start < INT_MAX);
1722 assert(end < INT_MAX);
1723 return PyObject_CallFunction(PyExc_UnicodeDecodeError, "ss#nns",
1724 encoding, object, length, start, end, reason);
1729 * UnicodeTranslateError extends UnicodeError
1732 static int
1733 UnicodeTranslateError_init(PyUnicodeErrorObject *self, PyObject *args,
1734 PyObject *kwds)
1736 if (BaseException_init((PyBaseExceptionObject *)self, args, kwds) == -1)
1737 return -1;
1739 Py_CLEAR(self->object);
1740 Py_CLEAR(self->reason);
1742 if (!PyArg_ParseTuple(args, "O!nnO!",
1743 &PyUnicode_Type, &self->object,
1744 &self->start,
1745 &self->end,
1746 &PyString_Type, &self->reason)) {
1747 self->object = self->reason = NULL;
1748 return -1;
1751 Py_INCREF(self->object);
1752 Py_INCREF(self->reason);
1754 return 0;
1758 static PyObject *
1759 UnicodeTranslateError_str(PyObject *self)
1761 PyUnicodeErrorObject *uself = (PyUnicodeErrorObject *)self;
1763 if (uself->end==uself->start+1) {
1764 int badchar = (int)PyUnicode_AS_UNICODE(uself->object)[uself->start];
1765 char badchar_str[20];
1766 if (badchar <= 0xff)
1767 PyOS_snprintf(badchar_str, sizeof(badchar_str), "x%02x", badchar);
1768 else if (badchar <= 0xffff)
1769 PyOS_snprintf(badchar_str, sizeof(badchar_str), "u%04x", badchar);
1770 else
1771 PyOS_snprintf(badchar_str, sizeof(badchar_str), "U%08x", badchar);
1772 return PyString_FromFormat(
1773 "can't translate character u'\\%s' in position %zd: %.400s",
1774 badchar_str,
1775 uself->start,
1776 PyString_AS_STRING(uself->reason)
1779 return PyString_FromFormat(
1780 "can't translate characters in position %zd-%zd: %.400s",
1781 uself->start,
1782 uself->end-1,
1783 PyString_AS_STRING(uself->reason)
1787 static PyTypeObject _PyExc_UnicodeTranslateError = {
1788 PyObject_HEAD_INIT(NULL)
1790 EXC_MODULE_NAME "UnicodeTranslateError",
1791 sizeof(PyUnicodeErrorObject), 0,
1792 (destructor)UnicodeError_dealloc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
1793 (reprfunc)UnicodeTranslateError_str, 0, 0, 0,
1794 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC,
1795 PyDoc_STR("Unicode translation error."), (traverseproc)UnicodeError_traverse,
1796 (inquiry)UnicodeError_clear, 0, 0, 0, 0, 0, UnicodeError_members,
1797 0, &_PyExc_UnicodeError, 0, 0, 0, offsetof(PyUnicodeErrorObject, dict),
1798 (initproc)UnicodeTranslateError_init, 0, BaseException_new,
1800 PyObject *PyExc_UnicodeTranslateError = (PyObject *)&_PyExc_UnicodeTranslateError;
1802 PyObject *
1803 PyUnicodeTranslateError_Create(
1804 const Py_UNICODE *object, Py_ssize_t length,
1805 Py_ssize_t start, Py_ssize_t end, const char *reason)
1807 return PyObject_CallFunction(PyExc_UnicodeTranslateError, "u#nns",
1808 object, length, start, end, reason);
1810 #endif
1814 * AssertionError extends StandardError
1816 SimpleExtendsException(PyExc_StandardError, AssertionError,
1817 "Assertion failed.");
1821 * ArithmeticError extends StandardError
1823 SimpleExtendsException(PyExc_StandardError, ArithmeticError,
1824 "Base class for arithmetic errors.");
1828 * FloatingPointError extends ArithmeticError
1830 SimpleExtendsException(PyExc_ArithmeticError, FloatingPointError,
1831 "Floating point operation failed.");
1835 * OverflowError extends ArithmeticError
1837 SimpleExtendsException(PyExc_ArithmeticError, OverflowError,
1838 "Result too large to be represented.");
1842 * ZeroDivisionError extends ArithmeticError
1844 SimpleExtendsException(PyExc_ArithmeticError, ZeroDivisionError,
1845 "Second argument to a division or modulo operation was zero.");
1849 * SystemError extends StandardError
1851 SimpleExtendsException(PyExc_StandardError, SystemError,
1852 "Internal error in the Python interpreter.\n"
1853 "\n"
1854 "Please report this to the Python maintainer, along with the traceback,\n"
1855 "the Python version, and the hardware/OS platform and version.");
1859 * ReferenceError extends StandardError
1861 SimpleExtendsException(PyExc_StandardError, ReferenceError,
1862 "Weak ref proxy used after referent went away.");
1866 * MemoryError extends StandardError
1868 SimpleExtendsException(PyExc_StandardError, MemoryError, "Out of memory.");
1871 * BufferError extends StandardError
1873 SimpleExtendsException(PyExc_StandardError, BufferError, "Buffer error.");
1876 /* Warning category docstrings */
1879 * Warning extends Exception
1881 SimpleExtendsException(PyExc_Exception, Warning,
1882 "Base class for warning categories.");
1886 * UserWarning extends Warning
1888 SimpleExtendsException(PyExc_Warning, UserWarning,
1889 "Base class for warnings generated by user code.");
1893 * DeprecationWarning extends Warning
1895 SimpleExtendsException(PyExc_Warning, DeprecationWarning,
1896 "Base class for warnings about deprecated features.");
1900 * PendingDeprecationWarning extends Warning
1902 SimpleExtendsException(PyExc_Warning, PendingDeprecationWarning,
1903 "Base class for warnings about features which will be deprecated\n"
1904 "in the future.");
1908 * SyntaxWarning extends Warning
1910 SimpleExtendsException(PyExc_Warning, SyntaxWarning,
1911 "Base class for warnings about dubious syntax.");
1915 * RuntimeWarning extends Warning
1917 SimpleExtendsException(PyExc_Warning, RuntimeWarning,
1918 "Base class for warnings about dubious runtime behavior.");
1922 * FutureWarning extends Warning
1924 SimpleExtendsException(PyExc_Warning, FutureWarning,
1925 "Base class for warnings about constructs that will change semantically\n"
1926 "in the future.");
1930 * ImportWarning extends Warning
1932 SimpleExtendsException(PyExc_Warning, ImportWarning,
1933 "Base class for warnings about probable mistakes in module imports");
1937 * UnicodeWarning extends Warning
1939 SimpleExtendsException(PyExc_Warning, UnicodeWarning,
1940 "Base class for warnings about Unicode related problems, mostly\n"
1941 "related to conversion problems.");
1944 * BytesWarning extends Warning
1946 SimpleExtendsException(PyExc_Warning, BytesWarning,
1947 "Base class for warnings about bytes and buffer related problems, mostly\n"
1948 "related to conversion from str or comparing to str.");
1950 /* Pre-computed MemoryError instance. Best to create this as early as
1951 * possible and not wait until a MemoryError is actually raised!
1953 PyObject *PyExc_MemoryErrorInst=NULL;
1955 /* Pre-computed RuntimeError instance for when recursion depth is reached.
1956 Meant to be used when normalizing the exception for exceeding the recursion
1957 depth will cause its own infinite recursion.
1959 PyObject *PyExc_RecursionErrorInst = NULL;
1961 /* module global functions */
1962 static PyMethodDef functions[] = {
1963 /* Sentinel */
1964 {NULL, NULL}
1967 #define PRE_INIT(TYPE) if (PyType_Ready(&_PyExc_ ## TYPE) < 0) \
1968 Py_FatalError("exceptions bootstrapping error.");
1970 #define POST_INIT(TYPE) Py_INCREF(PyExc_ ## TYPE); \
1971 PyModule_AddObject(m, # TYPE, PyExc_ ## TYPE); \
1972 if (PyDict_SetItemString(bdict, # TYPE, PyExc_ ## TYPE)) \
1973 Py_FatalError("Module dictionary insertion problem.");
1976 PyMODINIT_FUNC
1977 _PyExc_Init(void)
1979 PyObject *m, *bltinmod, *bdict;
1981 PRE_INIT(BaseException)
1982 PRE_INIT(Exception)
1983 PRE_INIT(StandardError)
1984 PRE_INIT(TypeError)
1985 PRE_INIT(StopIteration)
1986 PRE_INIT(GeneratorExit)
1987 PRE_INIT(SystemExit)
1988 PRE_INIT(KeyboardInterrupt)
1989 PRE_INIT(ImportError)
1990 PRE_INIT(EnvironmentError)
1991 PRE_INIT(IOError)
1992 PRE_INIT(OSError)
1993 #ifdef MS_WINDOWS
1994 PRE_INIT(WindowsError)
1995 #endif
1996 #ifdef __VMS
1997 PRE_INIT(VMSError)
1998 #endif
1999 PRE_INIT(EOFError)
2000 PRE_INIT(RuntimeError)
2001 PRE_INIT(NotImplementedError)
2002 PRE_INIT(NameError)
2003 PRE_INIT(UnboundLocalError)
2004 PRE_INIT(AttributeError)
2005 PRE_INIT(SyntaxError)
2006 PRE_INIT(IndentationError)
2007 PRE_INIT(TabError)
2008 PRE_INIT(LookupError)
2009 PRE_INIT(IndexError)
2010 PRE_INIT(KeyError)
2011 PRE_INIT(ValueError)
2012 PRE_INIT(UnicodeError)
2013 #ifdef Py_USING_UNICODE
2014 PRE_INIT(UnicodeEncodeError)
2015 PRE_INIT(UnicodeDecodeError)
2016 PRE_INIT(UnicodeTranslateError)
2017 #endif
2018 PRE_INIT(AssertionError)
2019 PRE_INIT(ArithmeticError)
2020 PRE_INIT(FloatingPointError)
2021 PRE_INIT(OverflowError)
2022 PRE_INIT(ZeroDivisionError)
2023 PRE_INIT(SystemError)
2024 PRE_INIT(ReferenceError)
2025 PRE_INIT(MemoryError)
2026 PRE_INIT(BufferError)
2027 PRE_INIT(Warning)
2028 PRE_INIT(UserWarning)
2029 PRE_INIT(DeprecationWarning)
2030 PRE_INIT(PendingDeprecationWarning)
2031 PRE_INIT(SyntaxWarning)
2032 PRE_INIT(RuntimeWarning)
2033 PRE_INIT(FutureWarning)
2034 PRE_INIT(ImportWarning)
2035 PRE_INIT(UnicodeWarning)
2036 PRE_INIT(BytesWarning)
2038 m = Py_InitModule4("exceptions", functions, exceptions_doc,
2039 (PyObject *)NULL, PYTHON_API_VERSION);
2040 if (m == NULL) return;
2042 bltinmod = PyImport_ImportModule("__builtin__");
2043 if (bltinmod == NULL)
2044 Py_FatalError("exceptions bootstrapping error.");
2045 bdict = PyModule_GetDict(bltinmod);
2046 if (bdict == NULL)
2047 Py_FatalError("exceptions bootstrapping error.");
2049 POST_INIT(BaseException)
2050 POST_INIT(Exception)
2051 POST_INIT(StandardError)
2052 POST_INIT(TypeError)
2053 POST_INIT(StopIteration)
2054 POST_INIT(GeneratorExit)
2055 POST_INIT(SystemExit)
2056 POST_INIT(KeyboardInterrupt)
2057 POST_INIT(ImportError)
2058 POST_INIT(EnvironmentError)
2059 POST_INIT(IOError)
2060 POST_INIT(OSError)
2061 #ifdef MS_WINDOWS
2062 POST_INIT(WindowsError)
2063 #endif
2064 #ifdef __VMS
2065 POST_INIT(VMSError)
2066 #endif
2067 POST_INIT(EOFError)
2068 POST_INIT(RuntimeError)
2069 POST_INIT(NotImplementedError)
2070 POST_INIT(NameError)
2071 POST_INIT(UnboundLocalError)
2072 POST_INIT(AttributeError)
2073 POST_INIT(SyntaxError)
2074 POST_INIT(IndentationError)
2075 POST_INIT(TabError)
2076 POST_INIT(LookupError)
2077 POST_INIT(IndexError)
2078 POST_INIT(KeyError)
2079 POST_INIT(ValueError)
2080 POST_INIT(UnicodeError)
2081 #ifdef Py_USING_UNICODE
2082 POST_INIT(UnicodeEncodeError)
2083 POST_INIT(UnicodeDecodeError)
2084 POST_INIT(UnicodeTranslateError)
2085 #endif
2086 POST_INIT(AssertionError)
2087 POST_INIT(ArithmeticError)
2088 POST_INIT(FloatingPointError)
2089 POST_INIT(OverflowError)
2090 POST_INIT(ZeroDivisionError)
2091 POST_INIT(SystemError)
2092 POST_INIT(ReferenceError)
2093 POST_INIT(MemoryError)
2094 POST_INIT(BufferError)
2095 POST_INIT(Warning)
2096 POST_INIT(UserWarning)
2097 POST_INIT(DeprecationWarning)
2098 POST_INIT(PendingDeprecationWarning)
2099 POST_INIT(SyntaxWarning)
2100 POST_INIT(RuntimeWarning)
2101 POST_INIT(FutureWarning)
2102 POST_INIT(ImportWarning)
2103 POST_INIT(UnicodeWarning)
2104 POST_INIT(BytesWarning)
2106 PyExc_MemoryErrorInst = BaseException_new(&_PyExc_MemoryError, NULL, NULL);
2107 if (!PyExc_MemoryErrorInst)
2108 Py_FatalError("Cannot pre-allocate MemoryError instance");
2110 PyExc_RecursionErrorInst = BaseException_new(&_PyExc_RuntimeError, NULL, NULL);
2111 if (!PyExc_RecursionErrorInst)
2112 Py_FatalError("Cannot pre-allocate RuntimeError instance for "
2113 "recursion errors");
2114 else {
2115 PyBaseExceptionObject *err_inst =
2116 (PyBaseExceptionObject *)PyExc_RecursionErrorInst;
2117 PyObject *args_tuple;
2118 PyObject *exc_message;
2119 exc_message = PyString_FromString("maximum recursion depth exceeded");
2120 if (!exc_message)
2121 Py_FatalError("cannot allocate argument for RuntimeError "
2122 "pre-allocation");
2123 args_tuple = PyTuple_Pack(1, exc_message);
2124 if (!args_tuple)
2125 Py_FatalError("cannot allocate tuple for RuntimeError "
2126 "pre-allocation");
2127 Py_DECREF(exc_message);
2128 if (BaseException_init(err_inst, args_tuple, NULL))
2129 Py_FatalError("init of pre-allocated RuntimeError failed");
2130 Py_DECREF(args_tuple);
2133 Py_DECREF(bltinmod);
2136 void
2137 _PyExc_Fini(void)
2139 Py_XDECREF(PyExc_MemoryErrorInst);
2140 PyExc_MemoryErrorInst = NULL;