Mercurial > cpython-lru_cache-weakref
annotate Python/errors.c @ 37:c795fdaced9b legacy-trunk
Added intobject.h and tupleobject.h includes.
| author | Guido van Rossum <guido@python.org> |
|---|---|
| date | Fri, 26 Oct 1990 14:53:07 +0000 |
| parents | 2d3eb717a00d |
| children | 433f52d1d958 |
| rev | line source |
|---|---|
| 6 | 1 /* Error handling -- see also run.c */ |
| 2 | |
| 3 /* New error handling interface. | |
| 4 | |
| 5 The following problem exists (existed): methods of built-in modules | |
| 6 are called with 'self' and 'args' arguments, but without a context | |
| 7 argument, so they have no way to raise a specific exception. | |
| 8 The same is true for the object implementations: no context argument. | |
| 9 The old convention was to set 'errno' and to return NULL. | |
| 10 The caller (usually call_function() in eval.c) detects the NULL | |
| 11 return value and then calls puterrno(ctx) to turn the errno value | |
| 12 into a true exception. Problems with this approach are: | |
| 13 - it used standard errno values to indicate Python-specific errors, | |
| 14 but this means that when such an error code is reported by UNIX the | |
| 15 user gets a confusing message | |
| 16 - errno is a global variable, which makes extensions to a multi- | |
| 17 threading environment difficult; e.g., in IRIX, multi-threaded | |
| 18 programs must use the function getoserror() (sp.?) instead of | |
| 19 looking in errno | |
| 20 - there is no portable way to add new error numbers for specic | |
| 21 situations -- the value space for errno is reserved to the OS, yet | |
| 22 the way to turn module-specific errors into a module-specific | |
| 23 exception requires module-specific values for errno | |
| 24 - there is no way to add a more situation-specific message to an | |
| 25 error. | |
| 26 | |
| 27 The new interface solves all these problems. To return an error, a | |
| 28 built-in function calls err_set(exception), err_set(valexception, | |
| 29 value) or err_setstr(exception, string), and returns NULL. These | |
| 30 functions save the value for later use by puterrno(). To adapt this | |
| 31 scheme to a multi-threaded environment, only the implementation of | |
| 32 err_setval() has to be changed. | |
| 33 */ | |
| 34 | |
| 35 #include <stdio.h> | |
| 36 | |
| 37 #include "PROTO.h" | |
| 38 #include "object.h" | |
|
37
c795fdaced9b
Added intobject.h and tupleobject.h includes.
Guido van Rossum <guido@python.org>
parents:
22
diff
changeset
|
39 #include "intobject.h" |
| 6 | 40 #include "stringobject.h" |
|
37
c795fdaced9b
Added intobject.h and tupleobject.h includes.
Guido van Rossum <guido@python.org>
parents:
22
diff
changeset
|
41 #include "tupleobject.h" |
| 6 | 42 #include "errors.h" |
| 43 | |
| 44 /* Last exception stored by err_setval() */ | |
| 45 | |
| 46 static object *last_exception; | |
| 47 static object *last_exc_val; | |
| 48 | |
| 49 void | |
| 50 err_setval(exception, value) | |
| 51 object *exception; | |
| 52 object *value; | |
| 53 { | |
| 54 if (last_exception != NULL) | |
| 55 DECREF(last_exception); | |
| 56 if (exception != NULL) | |
| 57 INCREF(exception); | |
| 58 last_exception = exception; | |
| 59 | |
| 60 if (last_exc_val != NULL) | |
| 61 DECREF(last_exc_val); | |
| 62 if (value != NULL) | |
| 63 INCREF(value); | |
| 64 last_exc_val = value; | |
| 65 } | |
| 66 | |
| 67 void | |
| 68 err_set(exception) | |
| 69 object *exception; | |
| 70 { | |
| 71 err_setval(exception, (object *)NULL); | |
| 72 } | |
| 73 | |
| 74 void | |
| 75 err_setstr(exception, string) | |
| 76 object *exception; | |
| 77 char *string; | |
| 78 { | |
| 79 object *value = newstringobject(string); | |
| 80 err_setval(exception, value); | |
| 81 if (value != NULL) | |
| 82 DECREF(value); | |
| 83 } | |
| 84 | |
| 85 int | |
| 86 err_occurred() | |
| 87 { | |
| 88 return last_exception != NULL; | |
| 89 } | |
| 90 | |
| 91 void | |
| 92 err_get(p_exc, p_val) | |
| 93 object **p_exc; | |
| 94 object **p_val; | |
| 95 { | |
| 96 *p_exc = last_exception; | |
| 97 last_exception = NULL; | |
| 98 *p_val = last_exc_val; | |
| 99 last_exc_val = NULL; | |
| 100 } | |
| 101 | |
| 102 void | |
| 103 err_clear() | |
| 104 { | |
| 105 if (last_exception != NULL) { | |
| 106 DECREF(last_exception); | |
| 107 last_exception = NULL; | |
| 108 } | |
| 109 if (last_exc_val != NULL) { | |
| 110 DECREF(last_exc_val); | |
| 111 last_exc_val = NULL; | |
| 112 } | |
| 113 } | |
|
9
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
114 |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
115 /* Convenience functions to set a type error exception and return 0 */ |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
116 |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
117 int |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
118 err_badarg() |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
119 { |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
120 err_setstr(TypeError, "illegal argument type for built-in function"); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
121 return 0; |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
122 } |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
123 |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
124 object * |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
125 err_nomem() |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
126 { |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
127 err_setstr(MemoryError, "in built-in function"); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
128 return NULL; |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
129 } |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
130 |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
131 object * |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
132 err_errno(exc) |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
133 object *exc; |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
134 { |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
135 object *v = newtupleobject(2); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
136 if (v != NULL) { |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
137 settupleitem(v, 0, newintobject((long)errno)); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
138 settupleitem(v, 1, newstringobject(strerror(errno))); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
139 } |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
140 err_setval(exc, v); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
141 if (v != NULL) |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
142 DECREF(v); |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
143 return NULL; |
|
33701db4ea55
Adde dconvenience functions.
Guido van Rossum <guido@python.org>
parents:
6
diff
changeset
|
144 } |
| 22 | 145 |
| 146 void | |
| 147 err_badcall() | |
| 148 { | |
| 149 err_setstr(SystemError, "bad argument to internal function"); | |
| 150 } |