blob: 88bd20c29e5b3bc33eb730eee873d35e9d1c5392 [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002/* Class object implementation */
3
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004#include "Python.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00005#include "structmember.h"
Guido van Rossum04691fc1992-08-12 15:35:34 +00006
Guido van Rossum915f0eb2001-10-17 20:26:38 +00007#define TP_DESCR_GET(t) \
8 (PyType_HasFeature(t, Py_TPFLAGS_HAVE_CLASS) ? (t)->tp_descr_get : NULL)
9
Neil Schemenauer29bfc072001-01-04 01:43:46 +000010
Guido van Rossum52ca98a1994-09-05 07:32:29 +000011/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +000012static PyObject *class_lookup(PyClassObject *, PyObject *,
13 PyClassObject **);
14static PyObject *instance_getattr1(PyInstanceObject *, PyObject *);
15static PyObject *instance_getattr2(PyInstanceObject *, PyObject *);
Guido van Rossum52ca98a1994-09-05 07:32:29 +000016
Guido van Rossuma63eff61998-05-29 21:37:21 +000017static PyObject *getattrstr, *setattrstr, *delattrstr;
18
Fred Drake79912472000-07-09 04:06:11 +000019
Guido van Rossumc0b618a1997-05-02 03:12:38 +000020PyObject *
Fred Drake79912472000-07-09 04:06:11 +000021PyClass_New(PyObject *bases, PyObject *dict, PyObject *name)
22 /* bases is NULL or tuple of classobjects! */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000023{
Guido van Rossumc0b618a1997-05-02 03:12:38 +000024 PyClassObject *op, *dummy;
Guido van Rossum7cc56eb1997-09-12 20:04:46 +000025 static PyObject *docstr, *modstr, *namestr;
Guido van Rossum019f4241996-08-21 14:54:28 +000026 if (docstr == NULL) {
Guido van Rossuma412d241997-01-18 07:59:12 +000027 docstr= PyString_InternFromString("__doc__");
Guido van Rossum019f4241996-08-21 14:54:28 +000028 if (docstr == NULL)
29 return NULL;
30 }
Guido van Rossum7cc56eb1997-09-12 20:04:46 +000031 if (modstr == NULL) {
32 modstr= PyString_InternFromString("__module__");
33 if (modstr == NULL)
34 return NULL;
35 }
36 if (namestr == NULL) {
37 namestr= PyString_InternFromString("__name__");
38 if (namestr == NULL)
39 return NULL;
40 }
Guido van Rossum04d73c41997-10-07 14:54:11 +000041 if (name == NULL || !PyString_Check(name)) {
Tim Peters6d6c1a32001-08-02 04:15:00 +000042 PyErr_SetString(PyExc_TypeError,
Guido van Rossum04d73c41997-10-07 14:54:11 +000043 "PyClass_New: name must be a string");
44 return NULL;
45 }
46 if (dict == NULL || !PyDict_Check(dict)) {
Tim Peters6d6c1a32001-08-02 04:15:00 +000047 PyErr_SetString(PyExc_TypeError,
Guido van Rossum04d73c41997-10-07 14:54:11 +000048 "PyClass_New: dict must be a dictionary");
49 return NULL;
50 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +000051 if (PyDict_GetItem(dict, docstr) == NULL) {
52 if (PyDict_SetItem(dict, docstr, Py_None) < 0)
Guido van Rossume7d444f1995-01-07 12:35:18 +000053 return NULL;
54 }
Guido van Rossum7cc56eb1997-09-12 20:04:46 +000055 if (PyDict_GetItem(dict, modstr) == NULL) {
56 PyObject *globals = PyEval_GetGlobals();
57 if (globals != NULL) {
Guido van Rossum04d73c41997-10-07 14:54:11 +000058 PyObject *modname = PyDict_GetItem(globals, namestr);
59 if (modname != NULL) {
60 if (PyDict_SetItem(dict, modstr, modname) < 0)
Guido van Rossum7cc56eb1997-09-12 20:04:46 +000061 return NULL;
62 }
63 }
64 }
Guido van Rossume2966a61991-12-10 13:53:23 +000065 if (bases == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +000066 bases = PyTuple_New(0);
Guido van Rossume2966a61991-12-10 13:53:23 +000067 if (bases == NULL)
Guido van Rossume5372401993-03-16 12:15:04 +000068 return NULL;
Guido van Rossume2966a61991-12-10 13:53:23 +000069 }
Guido van Rossum04d73c41997-10-07 14:54:11 +000070 else {
Guido van Rossum28d80b12001-09-07 21:08:32 +000071 int i, n;
72 PyObject *base;
Guido van Rossum04d73c41997-10-07 14:54:11 +000073 if (!PyTuple_Check(bases)) {
Tim Peters6d6c1a32001-08-02 04:15:00 +000074 PyErr_SetString(PyExc_TypeError,
Guido van Rossum04d73c41997-10-07 14:54:11 +000075 "PyClass_New: bases must be a tuple");
76 return NULL;
77 }
Guido van Rossum28d80b12001-09-07 21:08:32 +000078 n = PyTuple_Size(bases);
79 for (i = 0; i < n; i++) {
80 base = PyTuple_GET_ITEM(bases, i);
81 if (!PyClass_Check(base)) {
82 if (PyCallable_Check(
83 (PyObject *) base->ob_type))
84 return PyObject_CallFunction(
85 (PyObject *) base->ob_type,
86 "OOO",
87 name,
88 bases,
89 dict);
Tim Peters6d6c1a32001-08-02 04:15:00 +000090 PyErr_SetString(PyExc_TypeError,
Guido van Rossum04d73c41997-10-07 14:54:11 +000091 "PyClass_New: base must be a class");
92 return NULL;
93 }
94 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +000095 Py_INCREF(bases);
Guido van Rossum04d73c41997-10-07 14:54:11 +000096 }
Neil Schemenauere83c00e2001-08-29 23:54:21 +000097 op = PyObject_GC_New(PyClassObject, &PyClass_Type);
Guido van Rossume2966a61991-12-10 13:53:23 +000098 if (op == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +000099 Py_DECREF(bases);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000100 return NULL;
Guido van Rossume2966a61991-12-10 13:53:23 +0000101 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000102 op->cl_bases = bases;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000103 Py_INCREF(dict);
Guido van Rossum81daa321993-05-20 14:24:46 +0000104 op->cl_dict = dict;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000105 Py_XINCREF(name);
Guido van Rossum94308391991-10-20 20:11:48 +0000106 op->cl_name = name;
Guido van Rossum2878a691996-08-09 20:53:24 +0000107 if (getattrstr == NULL) {
Guido van Rossuma412d241997-01-18 07:59:12 +0000108 getattrstr = PyString_InternFromString("__getattr__");
109 setattrstr = PyString_InternFromString("__setattr__");
110 delattrstr = PyString_InternFromString("__delattr__");
Guido van Rossum2878a691996-08-09 20:53:24 +0000111 }
112 op->cl_getattr = class_lookup(op, getattrstr, &dummy);
113 op->cl_setattr = class_lookup(op, setattrstr, &dummy);
114 op->cl_delattr = class_lookup(op, delattrstr, &dummy);
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000115 Py_XINCREF(op->cl_getattr);
116 Py_XINCREF(op->cl_setattr);
117 Py_XINCREF(op->cl_delattr);
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000118 _PyObject_GC_TRACK(op);
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000119 return (PyObject *) op;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000120}
121
Guido van Rossumb479dc52001-09-05 22:52:50 +0000122PyObject *
123PyMethod_Function(PyObject *im)
124{
125 if (!PyMethod_Check(im)) {
126 PyErr_BadInternalCall();
127 return NULL;
128 }
129 return ((PyMethodObject *)im)->im_func;
130}
131
132PyObject *
133PyMethod_Self(PyObject *im)
134{
135 if (!PyMethod_Check(im)) {
136 PyErr_BadInternalCall();
137 return NULL;
138 }
139 return ((PyMethodObject *)im)->im_self;
140}
141
142PyObject *
143PyMethod_Class(PyObject *im)
144{
145 if (!PyMethod_Check(im)) {
146 PyErr_BadInternalCall();
147 return NULL;
148 }
149 return ((PyMethodObject *)im)->im_class;
150}
151
Guido van Rossumbea18cc2002-06-14 20:41:17 +0000152PyDoc_STRVAR(class_doc,
153"classobj(name, bases, dict)\n\
154\n\
155Create a class object. The name must be a string; the second argument\n\
156a tuple of classes, and the third a dictionary.");
157
158static PyObject *
Tim Peters6d6c1a32001-08-02 04:15:00 +0000159class_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
160{
161 PyObject *name, *bases, *dict;
162 static char *kwlist[] = {"name", "bases", "dict", 0};
163
164 if (!PyArg_ParseTupleAndKeywords(args, kwds, "SOO", kwlist,
165 &name, &bases, &dict))
166 return NULL;
167 return PyClass_New(bases, dict, name);
168}
169
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000170/* Class methods */
171
172static void
Fred Drake79912472000-07-09 04:06:11 +0000173class_dealloc(PyClassObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000174{
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000175 _PyObject_GC_UNTRACK(op);
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000176 Py_DECREF(op->cl_bases);
177 Py_DECREF(op->cl_dict);
178 Py_XDECREF(op->cl_name);
Guido van Rossum152d8171998-08-04 14:59:16 +0000179 Py_XDECREF(op->cl_getattr);
180 Py_XDECREF(op->cl_setattr);
181 Py_XDECREF(op->cl_delattr);
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000182 PyObject_GC_Del(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000183}
184
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000185static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000186class_lookup(PyClassObject *cp, PyObject *name, PyClassObject **pclass)
Guido van Rossum81daa321993-05-20 14:24:46 +0000187{
188 int i, n;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000189 PyObject *value = PyDict_GetItem(cp->cl_dict, name);
Guido van Rossum81daa321993-05-20 14:24:46 +0000190 if (value != NULL) {
191 *pclass = cp;
192 return value;
193 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000194 n = PyTuple_Size(cp->cl_bases);
Guido van Rossum81daa321993-05-20 14:24:46 +0000195 for (i = 0; i < n; i++) {
Guido van Rossum7cc56eb1997-09-12 20:04:46 +0000196 /* XXX What if one of the bases is not a class? */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000197 PyObject *v = class_lookup(
198 (PyClassObject *)
199 PyTuple_GetItem(cp->cl_bases, i), name, pclass);
Guido van Rossum81daa321993-05-20 14:24:46 +0000200 if (v != NULL)
201 return v;
202 }
203 return NULL;
204}
205
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000206static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000207class_getattr(register PyClassObject *op, PyObject *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000208{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000209 register PyObject *v;
210 register char *sname = PyString_AsString(name);
211 PyClassObject *class;
Tim Peters6d6c1a32001-08-02 04:15:00 +0000212 descrgetfunc f;
213
Guido van Rossum2878a691996-08-09 20:53:24 +0000214 if (sname[0] == '_' && sname[1] == '_') {
215 if (strcmp(sname, "__dict__") == 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000216 if (PyEval_GetRestricted()) {
217 PyErr_SetString(PyExc_RuntimeError,
218 "class.__dict__ not accessible in restricted mode");
Guido van Rossum10393b11995-01-10 10:39:49 +0000219 return NULL;
220 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000221 Py_INCREF(op->cl_dict);
Guido van Rossum10393b11995-01-10 10:39:49 +0000222 return op->cl_dict;
223 }
Guido van Rossum2878a691996-08-09 20:53:24 +0000224 if (strcmp(sname, "__bases__") == 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000225 Py_INCREF(op->cl_bases);
Guido van Rossum10393b11995-01-10 10:39:49 +0000226 return op->cl_bases;
227 }
Guido van Rossum2878a691996-08-09 20:53:24 +0000228 if (strcmp(sname, "__name__") == 0) {
Guido van Rossum10393b11995-01-10 10:39:49 +0000229 if (op->cl_name == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000230 v = Py_None;
Guido van Rossum10393b11995-01-10 10:39:49 +0000231 else
232 v = op->cl_name;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000233 Py_INCREF(v);
Guido van Rossum10393b11995-01-10 10:39:49 +0000234 return v;
235 }
Guido van Rossum94308391991-10-20 20:11:48 +0000236 }
Guido van Rossum81daa321993-05-20 14:24:46 +0000237 v = class_lookup(op, name, &class);
Guido van Rossumb3f72581993-05-21 19:56:10 +0000238 if (v == NULL) {
Fred Drake661ea262000-10-24 19:57:45 +0000239 PyErr_Format(PyExc_AttributeError,
240 "class %.50s has no attribute '%.400s'",
241 PyString_AS_STRING(op->cl_name), sname);
Guido van Rossumb3f72581993-05-21 19:56:10 +0000242 return NULL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000243 }
Guido van Rossum915f0eb2001-10-17 20:26:38 +0000244 f = TP_DESCR_GET(v->ob_type);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000245 if (f == NULL)
246 Py_INCREF(v);
247 else
248 v = f(v, (PyObject *)NULL, (PyObject *)op);
Guido van Rossumb3f72581993-05-21 19:56:10 +0000249 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000250}
251
Guido van Rossuma63eff61998-05-29 21:37:21 +0000252static void
Fred Drake79912472000-07-09 04:06:11 +0000253set_slot(PyObject **slot, PyObject *v)
Guido van Rossuma63eff61998-05-29 21:37:21 +0000254{
255 PyObject *temp = *slot;
256 Py_XINCREF(v);
257 *slot = v;
258 Py_XDECREF(temp);
259}
260
Guido van Rossum7ba30431998-07-08 13:34:48 +0000261static void
Fred Drake79912472000-07-09 04:06:11 +0000262set_attr_slots(PyClassObject *c)
Guido van Rossum7ba30431998-07-08 13:34:48 +0000263{
264 PyClassObject *dummy;
265
266 set_slot(&c->cl_getattr, class_lookup(c, getattrstr, &dummy));
267 set_slot(&c->cl_setattr, class_lookup(c, setattrstr, &dummy));
268 set_slot(&c->cl_delattr, class_lookup(c, delattrstr, &dummy));
269}
270
Guido van Rossuma63eff61998-05-29 21:37:21 +0000271static char *
Fred Drake79912472000-07-09 04:06:11 +0000272set_dict(PyClassObject *c, PyObject *v)
Guido van Rossuma63eff61998-05-29 21:37:21 +0000273{
Guido van Rossuma63eff61998-05-29 21:37:21 +0000274 if (v == NULL || !PyDict_Check(v))
275 return "__dict__ must be a dictionary object";
276 set_slot(&c->cl_dict, v);
Guido van Rossum7ba30431998-07-08 13:34:48 +0000277 set_attr_slots(c);
Guido van Rossuma63eff61998-05-29 21:37:21 +0000278 return "";
279}
280
281static char *
Fred Drake79912472000-07-09 04:06:11 +0000282set_bases(PyClassObject *c, PyObject *v)
Guido van Rossuma63eff61998-05-29 21:37:21 +0000283{
Guido van Rossuma63eff61998-05-29 21:37:21 +0000284 int i, n;
285
286 if (v == NULL || !PyTuple_Check(v))
287 return "__bases__ must be a tuple object";
288 n = PyTuple_Size(v);
289 for (i = 0; i < n; i++) {
290 PyObject *x = PyTuple_GET_ITEM(v, i);
291 if (!PyClass_Check(x))
292 return "__bases__ items must be classes";
293 if (PyClass_IsSubclass(x, (PyObject *)c))
294 return "a __bases__ item causes an inheritance cycle";
295 }
296 set_slot(&c->cl_bases, v);
Guido van Rossum7ba30431998-07-08 13:34:48 +0000297 set_attr_slots(c);
Guido van Rossuma63eff61998-05-29 21:37:21 +0000298 return "";
299}
300
301static char *
Fred Drake79912472000-07-09 04:06:11 +0000302set_name(PyClassObject *c, PyObject *v)
Guido van Rossuma63eff61998-05-29 21:37:21 +0000303{
Guido van Rossuma63eff61998-05-29 21:37:21 +0000304 if (v == NULL || !PyString_Check(v))
305 return "__name__ must be a string object";
Guido van Rossumad89bbc2000-06-28 21:57:18 +0000306 if (strlen(PyString_AS_STRING(v)) != (size_t)PyString_GET_SIZE(v))
Guido van Rossuma63eff61998-05-29 21:37:21 +0000307 return "__name__ must not contain null bytes";
308 set_slot(&c->cl_name, v);
309 return "";
310}
311
Guido van Rossum94308391991-10-20 20:11:48 +0000312static int
Fred Drake79912472000-07-09 04:06:11 +0000313class_setattr(PyClassObject *op, PyObject *name, PyObject *v)
Guido van Rossum94308391991-10-20 20:11:48 +0000314{
Guido van Rossumb2173c31997-08-25 21:23:56 +0000315 char *sname;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000316 if (PyEval_GetRestricted()) {
317 PyErr_SetString(PyExc_RuntimeError,
Guido van Rossumac21f6a1995-08-04 04:05:31 +0000318 "classes are read-only in restricted mode");
319 return -1;
320 }
Guido van Rossumb2173c31997-08-25 21:23:56 +0000321 sname = PyString_AsString(name);
322 if (sname[0] == '_' && sname[1] == '_') {
323 int n = PyString_Size(name);
324 if (sname[n-1] == '_' && sname[n-2] == '_') {
Guido van Rossuma63eff61998-05-29 21:37:21 +0000325 char *err = NULL;
326 if (strcmp(sname, "__dict__") == 0)
327 err = set_dict(op, v);
328 else if (strcmp(sname, "__bases__") == 0)
329 err = set_bases(op, v);
330 else if (strcmp(sname, "__name__") == 0)
331 err = set_name(op, v);
332 else if (strcmp(sname, "__getattr__") == 0)
333 set_slot(&op->cl_getattr, v);
334 else if (strcmp(sname, "__setattr__") == 0)
335 set_slot(&op->cl_setattr, v);
336 else if (strcmp(sname, "__delattr__") == 0)
337 set_slot(&op->cl_delattr, v);
338 /* For the last three, we fall through to update the
339 dictionary as well. */
340 if (err != NULL) {
341 if (*err == '\0')
342 return 0;
343 PyErr_SetString(PyExc_TypeError, err);
Guido van Rossumb2173c31997-08-25 21:23:56 +0000344 return -1;
345 }
346 }
347 }
Guido van Rossum94472a01992-09-04 09:45:18 +0000348 if (v == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000349 int rv = PyDict_DelItem(op->cl_dict, name);
Guido van Rossum94472a01992-09-04 09:45:18 +0000350 if (rv < 0)
Fred Drake661ea262000-10-24 19:57:45 +0000351 PyErr_Format(PyExc_AttributeError,
352 "class %.50s has no attribute '%.400s'",
353 PyString_AS_STRING(op->cl_name), sname);
Guido van Rossum94472a01992-09-04 09:45:18 +0000354 return rv;
355 }
Guido van Rossum94308391991-10-20 20:11:48 +0000356 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000357 return PyDict_SetItem(op->cl_dict, name, v);
Guido van Rossum94308391991-10-20 20:11:48 +0000358}
359
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000360static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000361class_repr(PyClassObject *op)
Guido van Rossum25831651993-05-19 14:50:45 +0000362{
Guido van Rossum4a2a6211997-10-20 23:26:11 +0000363 PyObject *mod = PyDict_GetItemString(op->cl_dict, "__module__");
Guido van Rossum25831651993-05-19 14:50:45 +0000364 char *name;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000365 if (op->cl_name == NULL || !PyString_Check(op->cl_name))
Guido van Rossum25831651993-05-19 14:50:45 +0000366 name = "?";
367 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000368 name = PyString_AsString(op->cl_name);
Guido van Rossum4a2a6211997-10-20 23:26:11 +0000369 if (mod == NULL || !PyString_Check(mod))
Martin v. Löwiscf95f9c2001-09-18 20:23:28 +0000370 return PyString_FromFormat("<class ?.%s at %p>", name, op);
Guido van Rossum4a2a6211997-10-20 23:26:11 +0000371 else
Barry Warsaw7ce36942001-08-24 18:34:26 +0000372 return PyString_FromFormat("<class %s.%s at %p>",
373 PyString_AsString(mod),
374 name, op);
Guido van Rossum25831651993-05-19 14:50:45 +0000375}
376
Guido van Rossum4a2a6211997-10-20 23:26:11 +0000377static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000378class_str(PyClassObject *op)
Guido van Rossum4a2a6211997-10-20 23:26:11 +0000379{
380 PyObject *mod = PyDict_GetItemString(op->cl_dict, "__module__");
381 PyObject *name = op->cl_name;
382 PyObject *res;
383 int m, n;
384
385 if (name == NULL || !PyString_Check(name))
386 return class_repr(op);
387 if (mod == NULL || !PyString_Check(mod)) {
388 Py_INCREF(name);
389 return name;
390 }
391 m = PyString_Size(mod);
392 n = PyString_Size(name);
393 res = PyString_FromStringAndSize((char *)NULL, m+1+n);
394 if (res != NULL) {
395 char *s = PyString_AsString(res);
396 memcpy(s, PyString_AsString(mod), m);
397 s += m;
398 *s++ = '.';
399 memcpy(s, PyString_AsString(name), n);
400 }
401 return res;
402}
403
Jeremy Hylton8caad492000-06-23 14:18:11 +0000404static int
405class_traverse(PyClassObject *o, visitproc visit, void *arg)
406{
407 int err;
408 if (o->cl_bases) {
409 err = visit(o->cl_bases, arg);
410 if (err)
411 return err;
412 }
413 if (o->cl_dict) {
414 err = visit(o->cl_dict, arg);
415 if (err)
416 return err;
417 }
418 if (o->cl_name) {
419 err = visit(o->cl_name, arg);
420 if (err)
421 return err;
422 }
423 if (o->cl_getattr) {
424 err = visit(o->cl_getattr, arg);
425 if (err)
426 return err;
427 }
428 if (o->cl_setattr) {
429 err = visit(o->cl_setattr, arg);
430 if (err)
431 return err;
432 }
433 if (o->cl_delattr) {
434 err = visit(o->cl_delattr, arg);
435 if (err)
436 return err;
437 }
438 return 0;
439}
440
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000441PyTypeObject PyClass_Type = {
442 PyObject_HEAD_INIT(&PyType_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000443 0,
Guido van Rossumbea18cc2002-06-14 20:41:17 +0000444 "classobj",
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000445 sizeof(PyClassObject),
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000446 0,
Guido van Rossum8998b4f2001-01-17 15:28:20 +0000447 (destructor)class_dealloc, /* tp_dealloc */
448 0, /* tp_print */
449 0, /* tp_getattr */
450 0, /* tp_setattr */
451 0, /* tp_compare */
452 (reprfunc)class_repr, /* tp_repr */
453 0, /* tp_as_number */
454 0, /* tp_as_sequence */
455 0, /* tp_as_mapping */
456 0, /* tp_hash */
Tim Peters6d6c1a32001-08-02 04:15:00 +0000457 PyInstance_New, /* tp_call */
Guido van Rossum8998b4f2001-01-17 15:28:20 +0000458 (reprfunc)class_str, /* tp_str */
459 (getattrofunc)class_getattr, /* tp_getattro */
460 (setattrofunc)class_setattr, /* tp_setattro */
461 0, /* tp_as_buffer */
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000462 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC,/* tp_flags */
Guido van Rossumbea18cc2002-06-14 20:41:17 +0000463 class_doc, /* tp_doc */
Guido van Rossum8998b4f2001-01-17 15:28:20 +0000464 (traverseproc)class_traverse, /* tp_traverse */
Tim Peters6d6c1a32001-08-02 04:15:00 +0000465 0, /* tp_clear */
466 0, /* tp_richcompare */
467 0, /* tp_weaklistoffset */
468 0, /* tp_iter */
469 0, /* tp_iternext */
470 0, /* tp_methods */
471 0, /* tp_members */
472 0, /* tp_getset */
473 0, /* tp_base */
474 0, /* tp_dict */
475 0, /* tp_descr_get */
476 0, /* tp_descr_set */
477 0, /* tp_dictoffset */
478 0, /* tp_init */
479 0, /* tp_alloc */
480 class_new, /* tp_new */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000481};
482
Guido van Rossum81daa321993-05-20 14:24:46 +0000483int
Fred Drake79912472000-07-09 04:06:11 +0000484PyClass_IsSubclass(PyObject *class, PyObject *base)
Guido van Rossum81daa321993-05-20 14:24:46 +0000485{
486 int i, n;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000487 PyClassObject *cp;
Guido van Rossum81daa321993-05-20 14:24:46 +0000488 if (class == base)
489 return 1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000490 if (class == NULL || !PyClass_Check(class))
Guido van Rossumeb6b33a1993-05-25 09:38:27 +0000491 return 0;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000492 cp = (PyClassObject *)class;
493 n = PyTuple_Size(cp->cl_bases);
Guido van Rossum81daa321993-05-20 14:24:46 +0000494 for (i = 0; i < n; i++) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000495 if (PyClass_IsSubclass(PyTuple_GetItem(cp->cl_bases, i), base))
Guido van Rossum81daa321993-05-20 14:24:46 +0000496 return 1;
497 }
498 return 0;
499}
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000500
Guido van Rossum81daa321993-05-20 14:24:46 +0000501
502/* Instance objects */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000503
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000504PyObject *
Fred Drake5cc2c8c2001-01-28 03:53:08 +0000505PyInstance_NewRaw(PyObject *klass, PyObject *dict)
506{
507 PyInstanceObject *inst;
508
509 if (!PyClass_Check(klass)) {
510 PyErr_BadInternalCall();
511 return NULL;
512 }
513 if (dict == NULL) {
514 dict = PyDict_New();
515 if (dict == NULL)
516 return NULL;
517 }
518 else {
519 if (!PyDict_Check(dict)) {
520 PyErr_BadInternalCall();
521 return NULL;
522 }
523 Py_INCREF(dict);
524 }
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000525 inst = PyObject_GC_New(PyInstanceObject, &PyInstance_Type);
Fred Drake5cc2c8c2001-01-28 03:53:08 +0000526 if (inst == NULL) {
527 Py_DECREF(dict);
528 return NULL;
529 }
Fred Drake4e262a92001-03-22 18:26:47 +0000530 inst->in_weakreflist = NULL;
Fred Drake5cc2c8c2001-01-28 03:53:08 +0000531 Py_INCREF(klass);
532 inst->in_class = (PyClassObject *)klass;
533 inst->in_dict = dict;
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000534 _PyObject_GC_TRACK(inst);
Fred Drake5cc2c8c2001-01-28 03:53:08 +0000535 return (PyObject *)inst;
536}
537
538PyObject *
539PyInstance_New(PyObject *klass, PyObject *arg, PyObject *kw)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000540{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000541 register PyInstanceObject *inst;
542 PyObject *init;
543 static PyObject *initstr;
Fred Drake5cc2c8c2001-01-28 03:53:08 +0000544
545 inst = (PyInstanceObject *) PyInstance_NewRaw(klass, NULL);
Guido van Rossume8122f11991-05-05 20:03:07 +0000546 if (inst == NULL)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000547 return NULL;
Guido van Rossum2878a691996-08-09 20:53:24 +0000548 if (initstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +0000549 initstr = PyString_InternFromString("__init__");
Jeremy Hylton9e392e22000-04-26 20:39:20 +0000550 init = instance_getattr2(inst, initstr);
Guido van Rossum25831651993-05-19 14:50:45 +0000551 if (init == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000552 if ((arg != NULL && (!PyTuple_Check(arg) ||
553 PyTuple_Size(arg) != 0))
554 || (kw != NULL && (!PyDict_Check(kw) ||
555 PyDict_Size(kw) != 0))) {
556 PyErr_SetString(PyExc_TypeError,
Guido van Rossuma83f2701995-07-26 18:07:32 +0000557 "this constructor takes no arguments");
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000558 Py_DECREF(inst);
Guido van Rossum25831651993-05-19 14:50:45 +0000559 inst = NULL;
560 }
561 }
562 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000563 PyObject *res = PyEval_CallObjectWithKeywords(init, arg, kw);
564 Py_DECREF(init);
Guido van Rossum25831651993-05-19 14:50:45 +0000565 if (res == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000566 Py_DECREF(inst);
Guido van Rossum25831651993-05-19 14:50:45 +0000567 inst = NULL;
568 }
569 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000570 if (res != Py_None) {
571 PyErr_SetString(PyExc_TypeError,
Guido van Rossum25831651993-05-19 14:50:45 +0000572 "__init__() should return None");
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000573 Py_DECREF(inst);
Guido van Rossum25831651993-05-19 14:50:45 +0000574 inst = NULL;
575 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000576 Py_DECREF(res);
Guido van Rossum25831651993-05-19 14:50:45 +0000577 }
578 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000579 return (PyObject *)inst;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000580}
581
Guido van Rossum21ed88c1991-04-04 10:42:10 +0000582/* Instance methods */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000583
Guido van Rossumbea18cc2002-06-14 20:41:17 +0000584PyDoc_STRVAR(instance_doc,
585"instance(class[, dict])\n\
586\n\
587Create an instance without calling its __init__() method.\n\
588The class must be a classic class.\n\
589If present, dict must be a dictionary or None.");
590
591static PyObject *
592instance_new(PyTypeObject* type, PyObject* args, PyObject *kw)
593{
594 PyObject *klass;
595 PyObject *dict = Py_None;
596
597 if (!PyArg_ParseTuple(args, "O!|O:instance",
598 &PyClass_Type, &klass, &dict))
599 return NULL;
600
601 if (dict == Py_None)
602 dict = NULL;
603 else if (!PyDict_Check(dict)) {
604 PyErr_SetString(PyExc_TypeError,
605 "instance() second arg must be dictionary or None");
606 return NULL;
607 }
608 return PyInstance_NewRaw(klass, dict);
609}
610
611
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000612static void
Fred Drake79912472000-07-09 04:06:11 +0000613instance_dealloc(register PyInstanceObject *inst)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000614{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000615 PyObject *error_type, *error_value, *error_traceback;
616 PyObject *del;
617 static PyObject *delstr;
Tim Peters6b184912000-09-17 14:40:17 +0000618#ifdef Py_REF_DEBUG
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000619 extern long _Py_RefTotal;
Skip Montanaro4ca150b2000-07-08 12:04:57 +0000620#endif
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000621 _PyObject_GC_UNTRACK(inst);
Fred Drakec916f5a2001-10-26 17:56:51 +0000622 if (inst->in_weakreflist != NULL)
623 PyObject_ClearWeakRefs((PyObject *) inst);
Fred Drake41deb1e2001-02-01 05:27:45 +0000624
Tim Peters6b184912000-09-17 14:40:17 +0000625 /* Temporarily resurrect the object. */
Guido van Rossum441e4ab1996-05-23 22:46:51 +0000626#ifdef Py_TRACE_REFS
Tim Peters6b184912000-09-17 14:40:17 +0000627#ifndef Py_REF_DEBUG
628# error "Py_TRACE_REFS defined but Py_REF_DEBUG not."
629#endif
Guido van Rossum441e4ab1996-05-23 22:46:51 +0000630 /* much too complicated if Py_TRACE_REFS defined */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000631 inst->ob_type = &PyInstance_Type;
Guido van Rossumbffd6832000-01-20 22:32:56 +0000632 _Py_NewReference((PyObject *)inst);
Sjoerd Mullender740f3571995-08-28 09:00:43 +0000633#ifdef COUNT_ALLOCS
Tim Peters6b184912000-09-17 14:40:17 +0000634 /* compensate for boost in _Py_NewReference; note that
635 * _Py_RefTotal was also boosted; we'll knock that down later.
636 */
Tim Peters6d6c1a32001-08-02 04:15:00 +0000637 inst->ob_type->tp_allocs--;
Sjoerd Mullender740f3571995-08-28 09:00:43 +0000638#endif
Guido van Rossum441e4ab1996-05-23 22:46:51 +0000639#else /* !Py_TRACE_REFS */
Tim Peters6b184912000-09-17 14:40:17 +0000640 /* Py_INCREF boosts _Py_RefTotal if Py_REF_DEBUG is defined */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000641 Py_INCREF(inst);
Guido van Rossum441e4ab1996-05-23 22:46:51 +0000642#endif /* !Py_TRACE_REFS */
Tim Peters6b184912000-09-17 14:40:17 +0000643
644 /* Save the current exception, if any. */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000645 PyErr_Fetch(&error_type, &error_value, &error_traceback);
Tim Peters6b184912000-09-17 14:40:17 +0000646 /* Execute __del__ method, if any. */
Guido van Rossum2878a691996-08-09 20:53:24 +0000647 if (delstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +0000648 delstr = PyString_InternFromString("__del__");
Jeremy Hylton9e392e22000-04-26 20:39:20 +0000649 if ((del = instance_getattr2(inst, delstr)) != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000650 PyObject *res = PyEval_CallObject(del, (PyObject *)NULL);
Tim Peters6b184912000-09-17 14:40:17 +0000651 if (res == NULL)
Jeremy Hyltonb709df32000-09-01 02:47:25 +0000652 PyErr_WriteUnraisable(del);
Guido van Rossum0dfcf751996-08-12 22:00:53 +0000653 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000654 Py_DECREF(res);
655 Py_DECREF(del);
Guido van Rossum25831651993-05-19 14:50:45 +0000656 }
Tim Peters6b184912000-09-17 14:40:17 +0000657 /* Restore the saved exception. */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000658 PyErr_Restore(error_type, error_value, error_traceback);
Tim Peters6b184912000-09-17 14:40:17 +0000659 /* Undo the temporary resurrection; can't use DECREF here, it would
660 * cause a recursive call.
661 */
662#ifdef Py_REF_DEBUG
663 /* _Py_RefTotal was boosted either by _Py_NewReference or
664 * Py_INCREF above.
665 */
666 _Py_RefTotal--;
667#endif
Sjoerd Mullender740f3571995-08-28 09:00:43 +0000668 if (--inst->ob_refcnt > 0) {
669#ifdef COUNT_ALLOCS
Tim Peters6d6c1a32001-08-02 04:15:00 +0000670 inst->ob_type->tp_frees--;
Sjoerd Mullender740f3571995-08-28 09:00:43 +0000671#endif
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000672 _PyObject_GC_TRACK(inst);
Guido van Rossum25831651993-05-19 14:50:45 +0000673 return; /* __del__ added a reference; don't delete now */
Sjoerd Mullender740f3571995-08-28 09:00:43 +0000674 }
Guido van Rossum441e4ab1996-05-23 22:46:51 +0000675#ifdef Py_TRACE_REFS
Guido van Rossumbffd6832000-01-20 22:32:56 +0000676 _Py_ForgetReference((PyObject *)inst);
Tim Peters6b184912000-09-17 14:40:17 +0000677#ifdef COUNT_ALLOCS
678 /* compensate for increment in _Py_ForgetReference */
Tim Peters6d6c1a32001-08-02 04:15:00 +0000679 inst->ob_type->tp_frees--;
Tim Peters6b184912000-09-17 14:40:17 +0000680#endif
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000681#ifndef WITH_CYCLE_GC
Sjoerd Mullender740f3571995-08-28 09:00:43 +0000682 inst->ob_type = NULL;
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000683#endif
Tim Peters6b184912000-09-17 14:40:17 +0000684#endif
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000685 Py_DECREF(inst->in_class);
686 Py_XDECREF(inst->in_dict);
Neil Schemenauere83c00e2001-08-29 23:54:21 +0000687 PyObject_GC_Del(inst);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000688}
689
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000690static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000691instance_getattr1(register PyInstanceObject *inst, PyObject *name)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000692{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000693 register PyObject *v;
694 register char *sname = PyString_AsString(name);
Guido van Rossum2878a691996-08-09 20:53:24 +0000695 if (sname[0] == '_' && sname[1] == '_') {
696 if (strcmp(sname, "__dict__") == 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000697 if (PyEval_GetRestricted()) {
698 PyErr_SetString(PyExc_RuntimeError,
699 "instance.__dict__ not accessible in restricted mode");
Guido van Rossum10393b11995-01-10 10:39:49 +0000700 return NULL;
701 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000702 Py_INCREF(inst->in_dict);
Sjoerd Mullender3bb8a051993-10-22 12:04:32 +0000703 return inst->in_dict;
704 }
Guido van Rossum2878a691996-08-09 20:53:24 +0000705 if (strcmp(sname, "__class__") == 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000706 Py_INCREF(inst->in_class);
707 return (PyObject *)inst->in_class;
Sjoerd Mullender3bb8a051993-10-22 12:04:32 +0000708 }
Guido van Rossum94308391991-10-20 20:11:48 +0000709 }
Jeremy Hylton9e392e22000-04-26 20:39:20 +0000710 v = instance_getattr2(inst, name);
711 if (v == NULL) {
Fred Drake661ea262000-10-24 19:57:45 +0000712 PyErr_Format(PyExc_AttributeError,
713 "%.50s instance has no attribute '%.400s'",
Jeremy Hylton9e392e22000-04-26 20:39:20 +0000714 PyString_AS_STRING(inst->in_class->cl_name), sname);
715 }
716 return v;
717}
718
719static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000720instance_getattr2(register PyInstanceObject *inst, PyObject *name)
Jeremy Hylton9e392e22000-04-26 20:39:20 +0000721{
722 register PyObject *v;
723 PyClassObject *class;
Tim Peters6d6c1a32001-08-02 04:15:00 +0000724 descrgetfunc f;
725
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000726 v = PyDict_GetItem(inst->in_dict, name);
Guido van Rossumf23c41d2001-08-17 13:43:27 +0000727 if (v != NULL) {
728 Py_INCREF(v);
729 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000730 }
Guido van Rossumf23c41d2001-08-17 13:43:27 +0000731 v = class_lookup(inst->in_class, name, &class);
732 if (v != NULL) {
733 Py_INCREF(v);
Guido van Rossum915f0eb2001-10-17 20:26:38 +0000734 f = TP_DESCR_GET(v->ob_type);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000735 if (f != NULL) {
736 PyObject *w = f(v, (PyObject *)inst,
737 (PyObject *)(inst->in_class));
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000738 Py_DECREF(v);
Guido van Rossum21d335e1993-10-15 13:01:11 +0000739 v = w;
740 }
Guido van Rossumb3f72581993-05-21 19:56:10 +0000741 }
742 return v;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000743}
744
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000745static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000746instance_getattr(register PyInstanceObject *inst, PyObject *name)
Guido van Rossume7737541994-09-05 07:31:41 +0000747{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000748 register PyObject *func, *res;
Guido van Rossum52ca98a1994-09-05 07:32:29 +0000749 res = instance_getattr1(inst, name);
750 if (res == NULL && (func = inst->in_class->cl_getattr) != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000751 PyObject *args;
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000752 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
753 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000754 PyErr_Clear();
755 args = Py_BuildValue("(OO)", inst, name);
Guido van Rossum52ca98a1994-09-05 07:32:29 +0000756 if (args == NULL)
Guido van Rossume7737541994-09-05 07:31:41 +0000757 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000758 res = PyEval_CallObject(func, args);
759 Py_DECREF(args);
Guido van Rossume7737541994-09-05 07:31:41 +0000760 }
761 return res;
762}
763
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000764static int
Fred Drake79912472000-07-09 04:06:11 +0000765instance_setattr1(PyInstanceObject *inst, PyObject *name, PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000766{
Guido van Rossum94472a01992-09-04 09:45:18 +0000767 if (v == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000768 int rv = PyDict_DelItem(inst->in_dict, name);
Guido van Rossum94472a01992-09-04 09:45:18 +0000769 if (rv < 0)
Fred Drake661ea262000-10-24 19:57:45 +0000770 PyErr_Format(PyExc_AttributeError,
771 "%.50s instance has no attribute '%.400s'",
772 PyString_AS_STRING(inst->in_class->cl_name),
773 PyString_AS_STRING(name));
Guido van Rossum94472a01992-09-04 09:45:18 +0000774 return rv;
775 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000776 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000777 return PyDict_SetItem(inst->in_dict, name, v);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000778}
779
Guido van Rossume7737541994-09-05 07:31:41 +0000780static int
Fred Drake79912472000-07-09 04:06:11 +0000781instance_setattr(PyInstanceObject *inst, PyObject *name, PyObject *v)
Guido van Rossume7737541994-09-05 07:31:41 +0000782{
Guido van Rossumb2173c31997-08-25 21:23:56 +0000783 PyObject *func, *args, *res, *tmp;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000784 char *sname = PyString_AsString(name);
Guido van Rossumb2173c31997-08-25 21:23:56 +0000785 if (sname[0] == '_' && sname[1] == '_') {
786 int n = PyString_Size(name);
Guido van Rossum2878a691996-08-09 20:53:24 +0000787 if (sname[n-1] == '_' && sname[n-2] == '_') {
Guido van Rossumb2173c31997-08-25 21:23:56 +0000788 if (strcmp(sname, "__dict__") == 0) {
789 if (PyEval_GetRestricted()) {
790 PyErr_SetString(PyExc_RuntimeError,
791 "__dict__ not accessible in restricted mode");
792 return -1;
793 }
794 if (v == NULL || !PyDict_Check(v)) {
795 PyErr_SetString(PyExc_TypeError,
796 "__dict__ must be set to a dictionary");
797 return -1;
798 }
799 tmp = inst->in_dict;
800 Py_INCREF(v);
801 inst->in_dict = v;
802 Py_DECREF(tmp);
803 return 0;
804 }
805 if (strcmp(sname, "__class__") == 0) {
806 if (PyEval_GetRestricted()) {
807 PyErr_SetString(PyExc_RuntimeError,
808 "__class__ not accessible in restricted mode");
809 return -1;
810 }
811 if (v == NULL || !PyClass_Check(v)) {
812 PyErr_SetString(PyExc_TypeError,
813 "__class__ must be set to a class");
814 return -1;
815 }
816 tmp = (PyObject *)(inst->in_class);
817 Py_INCREF(v);
818 inst->in_class = (PyClassObject *)v;
819 Py_DECREF(tmp);
820 return 0;
821 }
Guido van Rossume7737541994-09-05 07:31:41 +0000822 }
Guido van Rossume7737541994-09-05 07:31:41 +0000823 }
Guido van Rossum52ca98a1994-09-05 07:32:29 +0000824 if (v == NULL)
825 func = inst->in_class->cl_delattr;
826 else
827 func = inst->in_class->cl_setattr;
828 if (func == NULL)
829 return instance_setattr1(inst, name, v);
830 if (v == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000831 args = Py_BuildValue("(OO)", inst, name);
Guido van Rossum52ca98a1994-09-05 07:32:29 +0000832 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000833 args = Py_BuildValue("(OOO)", inst, name, v);
Guido van Rossum52ca98a1994-09-05 07:32:29 +0000834 if (args == NULL)
835 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000836 res = PyEval_CallObject(func, args);
837 Py_DECREF(args);
Guido van Rossum52ca98a1994-09-05 07:32:29 +0000838 if (res == NULL)
839 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000840 Py_DECREF(res);
Guido van Rossume7737541994-09-05 07:31:41 +0000841 return 0;
842}
843
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000844static PyObject *
Fred Drake79912472000-07-09 04:06:11 +0000845instance_repr(PyInstanceObject *inst)
Guido van Rossum04691fc1992-08-12 15:35:34 +0000846{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000847 PyObject *func;
848 PyObject *res;
849 static PyObject *reprstr;
Guido van Rossum04691fc1992-08-12 15:35:34 +0000850
Guido van Rossum2878a691996-08-09 20:53:24 +0000851 if (reprstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +0000852 reprstr = PyString_InternFromString("__repr__");
Guido van Rossum2878a691996-08-09 20:53:24 +0000853 func = instance_getattr(inst, reprstr);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000854 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000855 PyObject *classname, *mod;
Guido van Rossum25831651993-05-19 14:50:45 +0000856 char *cname;
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000857 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
858 return NULL;
859 PyErr_Clear();
860 classname = inst->in_class->cl_name;
861 mod = PyDict_GetItemString(inst->in_class->cl_dict,
862 "__module__");
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000863 if (classname != NULL && PyString_Check(classname))
864 cname = PyString_AsString(classname);
Guido van Rossum25831651993-05-19 14:50:45 +0000865 else
866 cname = "?";
Guido van Rossumb7f1afe1997-12-03 00:06:02 +0000867 if (mod == NULL || !PyString_Check(mod))
Barry Warsaw7ce36942001-08-24 18:34:26 +0000868 return PyString_FromFormat("<?.%s instance at %p>",
869 cname, inst);
Guido van Rossumb7f1afe1997-12-03 00:06:02 +0000870 else
Barry Warsaw7ce36942001-08-24 18:34:26 +0000871 return PyString_FromFormat("<%s.%s instance at %p>",
872 PyString_AsString(mod),
873 cname, inst);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000874 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000875 res = PyEval_CallObject(func, (PyObject *)NULL);
876 Py_DECREF(func);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000877 return res;
878}
879
Guido van Rossum82c690f2001-04-30 14:39:18 +0000880static PyObject *
881instance_str(PyInstanceObject *inst)
882{
883 PyObject *func;
884 PyObject *res;
885 static PyObject *strstr;
886
887 if (strstr == NULL)
888 strstr = PyString_InternFromString("__str__");
889 func = instance_getattr(inst, strstr);
890 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000891 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
892 return NULL;
Guido van Rossum82c690f2001-04-30 14:39:18 +0000893 PyErr_Clear();
894 return instance_repr(inst);
895 }
896 res = PyEval_CallObject(func, (PyObject *)NULL);
897 Py_DECREF(func);
898 return res;
899}
900
Guido van Rossum9bfef441993-03-29 10:43:31 +0000901static long
Fred Drake79912472000-07-09 04:06:11 +0000902instance_hash(PyInstanceObject *inst)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000903{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000904 PyObject *func;
905 PyObject *res;
Guido van Rossum8a0c3451993-04-08 12:56:19 +0000906 long outcome;
Guido van Rossum65e8bd72001-01-18 23:46:31 +0000907 static PyObject *hashstr, *eqstr, *cmpstr;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000908
Guido van Rossum2878a691996-08-09 20:53:24 +0000909 if (hashstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +0000910 hashstr = PyString_InternFromString("__hash__");
Guido van Rossum2878a691996-08-09 20:53:24 +0000911 func = instance_getattr(inst, hashstr);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000912 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000913 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
914 return -1;
915 PyErr_Clear();
Guido van Rossum65e8bd72001-01-18 23:46:31 +0000916 /* If there is no __eq__ and no __cmp__ method, we hash on the
917 address. If an __eq__ or __cmp__ method exists, there must
918 be a __hash__. */
Guido van Rossum65e8bd72001-01-18 23:46:31 +0000919 if (eqstr == NULL)
920 eqstr = PyString_InternFromString("__eq__");
921 func = instance_getattr(inst, eqstr);
Guido van Rossum8a0c3451993-04-08 12:56:19 +0000922 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000923 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
924 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000925 PyErr_Clear();
Guido van Rossum65e8bd72001-01-18 23:46:31 +0000926 if (cmpstr == NULL)
927 cmpstr = PyString_InternFromString("__cmp__");
928 func = instance_getattr(inst, cmpstr);
929 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +0000930 if (!PyErr_ExceptionMatches(
931 PyExc_AttributeError))
932 return -1;
Guido van Rossum65e8bd72001-01-18 23:46:31 +0000933 PyErr_Clear();
934 return _Py_HashPointer(inst);
935 }
Guido van Rossum8a0c3451993-04-08 12:56:19 +0000936 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000937 PyErr_SetString(PyExc_TypeError, "unhashable instance");
Guido van Rossum9bfef441993-03-29 10:43:31 +0000938 return -1;
939 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000940 res = PyEval_CallObject(func, (PyObject *)NULL);
941 Py_DECREF(func);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000942 if (res == NULL)
943 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000944 if (PyInt_Check(res)) {
945 outcome = PyInt_AsLong(res);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000946 if (outcome == -1)
947 outcome = -2;
948 }
949 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000950 PyErr_SetString(PyExc_TypeError,
951 "__hash__() should return an int");
Guido van Rossum9bfef441993-03-29 10:43:31 +0000952 outcome = -1;
953 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000954 Py_DECREF(res);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000955 return outcome;
956}
957
Jeremy Hylton8caad492000-06-23 14:18:11 +0000958static int
959instance_traverse(PyInstanceObject *o, visitproc visit, void *arg)
960{
961 int err;
962 if (o->in_class) {
963 err = visit((PyObject *)(o->in_class), arg);
964 if (err)
965 return err;
966 }
967 if (o->in_dict) {
968 err = visit(o->in_dict, arg);
969 if (err)
970 return err;
971 }
Jeremy Hyltond22162b2000-06-23 17:14:56 +0000972 return 0;
Jeremy Hylton8caad492000-06-23 14:18:11 +0000973}
974
Guido van Rossum213c7a62001-04-23 14:08:49 +0000975static PyObject *getitemstr, *setitemstr, *delitemstr, *lenstr;
976static PyObject *iterstr, *nextstr;
Guido van Rossum2878a691996-08-09 20:53:24 +0000977
Guido van Rossum9bfef441993-03-29 10:43:31 +0000978static int
Fred Drake79912472000-07-09 04:06:11 +0000979instance_length(PyInstanceObject *inst)
Guido van Rossum04691fc1992-08-12 15:35:34 +0000980{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000981 PyObject *func;
982 PyObject *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +0000983 int outcome;
984
Guido van Rossum2878a691996-08-09 20:53:24 +0000985 if (lenstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +0000986 lenstr = PyString_InternFromString("__len__");
Guido van Rossum2878a691996-08-09 20:53:24 +0000987 func = instance_getattr(inst, lenstr);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000988 if (func == NULL)
989 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000990 res = PyEval_CallObject(func, (PyObject *)NULL);
991 Py_DECREF(func);
Guido van Rossumd014ea61992-11-26 10:30:26 +0000992 if (res == NULL)
993 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000994 if (PyInt_Check(res)) {
995 outcome = PyInt_AsLong(res);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000996 if (outcome < 0)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000997 PyErr_SetString(PyExc_ValueError,
998 "__len__() should return >= 0");
Guido van Rossum04691fc1992-08-12 15:35:34 +0000999 }
1000 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001001 PyErr_SetString(PyExc_TypeError,
1002 "__len__() should return an int");
Guido van Rossum04691fc1992-08-12 15:35:34 +00001003 outcome = -1;
1004 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001005 Py_DECREF(res);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001006 return outcome;
1007}
1008
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001009static PyObject *
Fred Drake79912472000-07-09 04:06:11 +00001010instance_subscript(PyInstanceObject *inst, PyObject *key)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001011{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001012 PyObject *func;
1013 PyObject *arg;
1014 PyObject *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001015
Guido van Rossum2878a691996-08-09 20:53:24 +00001016 if (getitemstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001017 getitemstr = PyString_InternFromString("__getitem__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001018 func = instance_getattr(inst, getitemstr);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001019 if (func == NULL)
1020 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001021 arg = Py_BuildValue("(O)", key);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001022 if (arg == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001023 Py_DECREF(func);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001024 return NULL;
1025 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001026 res = PyEval_CallObject(func, arg);
1027 Py_DECREF(func);
1028 Py_DECREF(arg);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001029 return res;
1030}
1031
Guido van Rossum9bfef441993-03-29 10:43:31 +00001032static int
Fred Drake79912472000-07-09 04:06:11 +00001033instance_ass_subscript(PyInstanceObject *inst, PyObject *key, PyObject *value)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001034{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001035 PyObject *func;
1036 PyObject *arg;
1037 PyObject *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001038
Guido van Rossum2878a691996-08-09 20:53:24 +00001039 if (value == NULL) {
1040 if (delitemstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001041 delitemstr = PyString_InternFromString("__delitem__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001042 func = instance_getattr(inst, delitemstr);
1043 }
1044 else {
1045 if (setitemstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001046 setitemstr = PyString_InternFromString("__setitem__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001047 func = instance_getattr(inst, setitemstr);
1048 }
Guido van Rossum04691fc1992-08-12 15:35:34 +00001049 if (func == NULL)
1050 return -1;
1051 if (value == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001052 arg = Py_BuildValue("(O)", key);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001053 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001054 arg = Py_BuildValue("(OO)", key, value);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001055 if (arg == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001056 Py_DECREF(func);
Guido van Rossum6d946f91992-08-14 13:49:30 +00001057 return -1;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001058 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001059 res = PyEval_CallObject(func, arg);
1060 Py_DECREF(func);
1061 Py_DECREF(arg);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001062 if (res == NULL)
1063 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001064 Py_DECREF(res);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001065 return 0;
1066}
1067
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001068static PyMappingMethods instance_as_mapping = {
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001069 (inquiry)instance_length, /* mp_length */
1070 (binaryfunc)instance_subscript, /* mp_subscript */
1071 (objobjargproc)instance_ass_subscript, /* mp_ass_subscript */
Guido van Rossum04691fc1992-08-12 15:35:34 +00001072};
1073
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001074static PyObject *
Fred Drake79912472000-07-09 04:06:11 +00001075instance_item(PyInstanceObject *inst, int i)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001076{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001077 PyObject *func, *arg, *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001078
Guido van Rossum2878a691996-08-09 20:53:24 +00001079 if (getitemstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001080 getitemstr = PyString_InternFromString("__getitem__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001081 func = instance_getattr(inst, getitemstr);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001082 if (func == NULL)
1083 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001084 arg = Py_BuildValue("(i)", i);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001085 if (arg == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001086 Py_DECREF(func);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001087 return NULL;
1088 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001089 res = PyEval_CallObject(func, arg);
1090 Py_DECREF(func);
1091 Py_DECREF(arg);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001092 return res;
1093}
1094
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001095static PyObject *
Thomas Wouters1d75a792000-08-17 22:37:32 +00001096sliceobj_from_intint(int i, int j)
1097{
1098 PyObject *start, *end, *res;
1099
1100 start = PyInt_FromLong((long)i);
1101 if (!start)
1102 return NULL;
1103
1104 end = PyInt_FromLong((long)j);
1105 if (!end) {
1106 Py_DECREF(start);
1107 return NULL;
1108 }
1109 res = PySlice_New(start, end, NULL);
1110 Py_DECREF(start);
1111 Py_DECREF(end);
1112 return res;
1113}
1114
1115
1116static PyObject *
Fred Drake79912472000-07-09 04:06:11 +00001117instance_slice(PyInstanceObject *inst, int i, int j)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001118{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001119 PyObject *func, *arg, *res;
1120 static PyObject *getslicestr;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001121
Guido van Rossum2878a691996-08-09 20:53:24 +00001122 if (getslicestr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001123 getslicestr = PyString_InternFromString("__getslice__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001124 func = instance_getattr(inst, getslicestr);
Thomas Wouters1d75a792000-08-17 22:37:32 +00001125
1126 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001127 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1128 return NULL;
Thomas Wouters1d75a792000-08-17 22:37:32 +00001129 PyErr_Clear();
1130
1131 if (getitemstr == NULL)
1132 getitemstr = PyString_InternFromString("__getitem__");
1133 func = instance_getattr(inst, getitemstr);
1134 if (func == NULL)
1135 return NULL;
1136 arg = Py_BuildValue("(N)", sliceobj_from_intint(i, j));
1137 } else
1138 arg = Py_BuildValue("(ii)", i, j);
1139
Guido van Rossum04691fc1992-08-12 15:35:34 +00001140 if (arg == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001141 Py_DECREF(func);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001142 return NULL;
1143 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001144 res = PyEval_CallObject(func, arg);
1145 Py_DECREF(func);
1146 Py_DECREF(arg);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001147 return res;
1148}
1149
1150static int
Fred Drake79912472000-07-09 04:06:11 +00001151instance_ass_item(PyInstanceObject *inst, int i, PyObject *item)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001152{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001153 PyObject *func, *arg, *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001154
Guido van Rossum2878a691996-08-09 20:53:24 +00001155 if (item == NULL) {
1156 if (delitemstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001157 delitemstr = PyString_InternFromString("__delitem__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001158 func = instance_getattr(inst, delitemstr);
1159 }
1160 else {
1161 if (setitemstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001162 setitemstr = PyString_InternFromString("__setitem__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001163 func = instance_getattr(inst, setitemstr);
1164 }
Guido van Rossum04691fc1992-08-12 15:35:34 +00001165 if (func == NULL)
Guido van Rossum6d946f91992-08-14 13:49:30 +00001166 return -1;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001167 if (item == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001168 arg = Py_BuildValue("i", i);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001169 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001170 arg = Py_BuildValue("(iO)", i, item);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001171 if (arg == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001172 Py_DECREF(func);
Guido van Rossum6d946f91992-08-14 13:49:30 +00001173 return -1;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001174 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001175 res = PyEval_CallObject(func, arg);
1176 Py_DECREF(func);
1177 Py_DECREF(arg);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001178 if (res == NULL)
1179 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001180 Py_DECREF(res);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001181 return 0;
1182}
1183
1184static int
Fred Drake79912472000-07-09 04:06:11 +00001185instance_ass_slice(PyInstanceObject *inst, int i, int j, PyObject *value)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001186{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001187 PyObject *func, *arg, *res;
1188 static PyObject *setslicestr, *delslicestr;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001189
Guido van Rossum2878a691996-08-09 20:53:24 +00001190 if (value == NULL) {
1191 if (delslicestr == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001192 delslicestr =
1193 PyString_InternFromString("__delslice__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001194 func = instance_getattr(inst, delslicestr);
Thomas Wouters1d75a792000-08-17 22:37:32 +00001195 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001196 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1197 return -1;
Thomas Wouters1d75a792000-08-17 22:37:32 +00001198 PyErr_Clear();
1199 if (delitemstr == NULL)
1200 delitemstr =
1201 PyString_InternFromString("__delitem__");
1202 func = instance_getattr(inst, delitemstr);
1203 if (func == NULL)
1204 return -1;
1205
1206 arg = Py_BuildValue("(N)",
1207 sliceobj_from_intint(i, j));
1208 } else
1209 arg = Py_BuildValue("(ii)", i, j);
Guido van Rossum2878a691996-08-09 20:53:24 +00001210 }
1211 else {
1212 if (setslicestr == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001213 setslicestr =
1214 PyString_InternFromString("__setslice__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001215 func = instance_getattr(inst, setslicestr);
Thomas Wouters1d75a792000-08-17 22:37:32 +00001216 if (func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001217 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1218 return -1;
Thomas Wouters1d75a792000-08-17 22:37:32 +00001219 PyErr_Clear();
1220 if (setitemstr == NULL)
1221 setitemstr =
1222 PyString_InternFromString("__setitem__");
1223 func = instance_getattr(inst, setitemstr);
1224 if (func == NULL)
1225 return -1;
1226
1227 arg = Py_BuildValue("(NO)",
1228 sliceobj_from_intint(i, j), value);
1229 } else
1230 arg = Py_BuildValue("(iiO)", i, j, value);
Guido van Rossum2878a691996-08-09 20:53:24 +00001231 }
Guido van Rossum04691fc1992-08-12 15:35:34 +00001232 if (arg == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001233 Py_DECREF(func);
Guido van Rossum6d946f91992-08-14 13:49:30 +00001234 return -1;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001235 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001236 res = PyEval_CallObject(func, arg);
1237 Py_DECREF(func);
1238 Py_DECREF(arg);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001239 if (res == NULL)
1240 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001241 Py_DECREF(res);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001242 return 0;
1243}
1244
Tim Peterscb8d3682001-05-05 21:05:01 +00001245static int
1246instance_contains(PyInstanceObject *inst, PyObject *member)
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001247{
1248 static PyObject *__contains__;
Tim Peterscb8d3682001-05-05 21:05:01 +00001249 PyObject *func;
1250
1251 /* Try __contains__ first.
1252 * If that can't be done, try iterator-based searching.
1253 */
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001254
1255 if(__contains__ == NULL) {
1256 __contains__ = PyString_InternFromString("__contains__");
1257 if(__contains__ == NULL)
1258 return -1;
1259 }
1260 func = instance_getattr(inst, __contains__);
Tim Peterscb8d3682001-05-05 21:05:01 +00001261 if (func) {
1262 PyObject *res;
1263 int ret;
1264 PyObject *arg = Py_BuildValue("(O)", member);
1265 if(arg == NULL) {
1266 Py_DECREF(func);
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001267 return -1;
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001268 }
Tim Peterscb8d3682001-05-05 21:05:01 +00001269 res = PyEval_CallObject(func, arg);
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001270 Py_DECREF(func);
Tim Peterscb8d3682001-05-05 21:05:01 +00001271 Py_DECREF(arg);
1272 if(res == NULL)
1273 return -1;
1274 ret = PyObject_IsTrue(res);
1275 Py_DECREF(res);
1276 return ret;
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001277 }
Tim Peterscb8d3682001-05-05 21:05:01 +00001278
1279 /* Couldn't find __contains__. */
1280 if (PyErr_ExceptionMatches(PyExc_AttributeError)) {
1281 /* Assume the failure was simply due to that there is no
1282 * __contains__ attribute, and try iterating instead.
1283 */
1284 PyErr_Clear();
Tim Peters16a77ad2001-09-08 04:00:12 +00001285 return _PySequence_IterSearch((PyObject *)inst, member,
1286 PY_ITERSEARCH_CONTAINS);
Tim Peterscb8d3682001-05-05 21:05:01 +00001287 }
1288 else
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001289 return -1;
Guido van Rossumee28c3a2000-02-28 15:03:15 +00001290}
1291
Fred Drake79912472000-07-09 04:06:11 +00001292static PySequenceMethods
1293instance_as_sequence = {
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001294 (inquiry)instance_length, /* sq_length */
1295 0, /* sq_concat */
1296 0, /* sq_repeat */
1297 (intargfunc)instance_item, /* sq_item */
1298 (intintargfunc)instance_slice, /* sq_slice */
1299 (intobjargproc)instance_ass_item, /* sq_ass_item */
1300 (intintobjargproc)instance_ass_slice, /* sq_ass_slice */
1301 (objobjproc)instance_contains, /* sq_contains */
Guido van Rossum04691fc1992-08-12 15:35:34 +00001302};
1303
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001304static PyObject *
Fred Drake79912472000-07-09 04:06:11 +00001305generic_unary_op(PyInstanceObject *self, PyObject *methodname)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001306{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001307 PyObject *func, *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001308
1309 if ((func = instance_getattr(self, methodname)) == NULL)
1310 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001311 res = PyEval_CallObject(func, (PyObject *)NULL);
1312 Py_DECREF(func);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001313 return res;
1314}
1315
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001316static PyObject *
1317generic_binary_op(PyObject *v, PyObject *w, char *opname)
Guido van Rossum03093a21994-09-28 15:51:32 +00001318{
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001319 PyObject *result;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001320 PyObject *args;
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001321 PyObject *func = PyObject_GetAttrString(v, opname);
Guido van Rossume7d444f1995-01-07 12:35:18 +00001322 if (func == NULL) {
Guido van Rossum617c1b01998-05-28 19:50:02 +00001323 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001324 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001325 PyErr_Clear();
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001326 Py_INCREF(Py_NotImplemented);
1327 return Py_NotImplemented;
Guido van Rossume7d444f1995-01-07 12:35:18 +00001328 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001329 args = Py_BuildValue("(O)", w);
Guido van Rossum03093a21994-09-28 15:51:32 +00001330 if (args == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001331 Py_DECREF(func);
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001332 return NULL;
Guido van Rossum03093a21994-09-28 15:51:32 +00001333 }
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001334 result = PyEval_CallObject(func, args);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001335 Py_DECREF(args);
1336 Py_DECREF(func);
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001337 return result;
1338}
1339
1340
1341static PyObject *coerce_obj;
1342
1343/* Try one half of a binary operator involving a class instance. */
1344static PyObject *
1345half_binop(PyObject *v, PyObject *w, char *opname, binaryfunc thisfunc,
1346 int swapped)
1347{
1348 PyObject *args;
1349 PyObject *coercefunc;
1350 PyObject *coerced = NULL;
1351 PyObject *v1;
1352 PyObject *result;
1353
1354 if (!PyInstance_Check(v)) {
1355 Py_INCREF(Py_NotImplemented);
1356 return Py_NotImplemented;
1357 }
1358
1359 if (coerce_obj == NULL) {
1360 coerce_obj = PyString_InternFromString("__coerce__");
1361 if (coerce_obj == NULL)
1362 return NULL;
1363 }
1364 coercefunc = PyObject_GetAttr(v, coerce_obj);
1365 if (coercefunc == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001366 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1367 return NULL;
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001368 PyErr_Clear();
1369 return generic_binary_op(v, w, opname);
1370 }
1371
1372 args = Py_BuildValue("(O)", w);
1373 if (args == NULL) {
1374 return NULL;
1375 }
1376 coerced = PyEval_CallObject(coercefunc, args);
1377 Py_DECREF(args);
1378 Py_DECREF(coercefunc);
1379 if (coerced == NULL) {
1380 return NULL;
1381 }
1382 if (coerced == Py_None || coerced == Py_NotImplemented) {
1383 Py_DECREF(coerced);
1384 return generic_binary_op(v, w, opname);
1385 }
1386 if (!PyTuple_Check(coerced) || PyTuple_Size(coerced) != 2) {
1387 Py_DECREF(coerced);
1388 PyErr_SetString(PyExc_TypeError,
1389 "coercion should return None or 2-tuple");
1390 return NULL;
1391 }
1392 v1 = PyTuple_GetItem(coerced, 0);
1393 w = PyTuple_GetItem(coerced, 1);
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001394 if (v1->ob_type == v->ob_type && PyInstance_Check(v)) {
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001395 /* prevent recursion if __coerce__ returns self as the first
1396 * argument */
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001397 result = generic_binary_op(v1, w, opname);
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001398 } else {
1399 if (swapped)
1400 result = (thisfunc)(w, v1);
1401 else
1402 result = (thisfunc)(v1, w);
1403 }
1404 Py_DECREF(coerced);
1405 return result;
1406}
1407
1408/* Implement a binary operator involving at least one class instance. */
1409static PyObject *
1410do_binop(PyObject *v, PyObject *w, char *opname, char *ropname,
1411 binaryfunc thisfunc)
1412{
1413 PyObject *result = half_binop(v, w, opname, thisfunc, 0);
1414 if (result == Py_NotImplemented) {
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001415 Py_DECREF(result);
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001416 result = half_binop(w, v, ropname, thisfunc, 1);
1417 }
1418 return result;
1419}
1420
1421static PyObject *
1422do_binop_inplace(PyObject *v, PyObject *w, char *iopname, char *opname,
1423 char *ropname, binaryfunc thisfunc)
1424{
1425 PyObject *result = half_binop(v, w, iopname, thisfunc, 0);
1426 if (result == Py_NotImplemented) {
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001427 Py_DECREF(result);
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001428 result = do_binop(v, w, opname, ropname, thisfunc);
1429 }
1430 return result;
Guido van Rossum03093a21994-09-28 15:51:32 +00001431}
1432
Guido van Rossum879c5811995-01-10 15:24:06 +00001433static int
Fred Drake79912472000-07-09 04:06:11 +00001434instance_coerce(PyObject **pv, PyObject **pw)
Guido van Rossum879c5811995-01-10 15:24:06 +00001435{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001436 PyObject *v = *pv;
1437 PyObject *w = *pw;
Guido van Rossum3931df91997-11-18 19:23:07 +00001438 PyObject *coercefunc;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001439 PyObject *args;
1440 PyObject *coerced;
Guido van Rossum879c5811995-01-10 15:24:06 +00001441
Guido van Rossum2878a691996-08-09 20:53:24 +00001442 if (coerce_obj == NULL) {
Guido van Rossuma412d241997-01-18 07:59:12 +00001443 coerce_obj = PyString_InternFromString("__coerce__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001444 if (coerce_obj == NULL)
1445 return -1;
1446 }
Guido van Rossum3931df91997-11-18 19:23:07 +00001447 coercefunc = PyObject_GetAttr(v, coerce_obj);
1448 if (coercefunc == NULL) {
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001449 /* No __coerce__ method */
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001450 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1451 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001452 PyErr_Clear();
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001453 return 1;
Guido van Rossum879c5811995-01-10 15:24:06 +00001454 }
1455 /* Has __coerce__ method: call it */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001456 args = Py_BuildValue("(O)", w);
Guido van Rossum879c5811995-01-10 15:24:06 +00001457 if (args == NULL) {
1458 return -1;
1459 }
Guido van Rossum3931df91997-11-18 19:23:07 +00001460 coerced = PyEval_CallObject(coercefunc, args);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001461 Py_DECREF(args);
Guido van Rossum3931df91997-11-18 19:23:07 +00001462 Py_DECREF(coercefunc);
Guido van Rossum879c5811995-01-10 15:24:06 +00001463 if (coerced == NULL) {
1464 /* __coerce__ call raised an exception */
1465 return -1;
1466 }
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001467 if (coerced == Py_None || coerced == Py_NotImplemented) {
Guido van Rossum879c5811995-01-10 15:24:06 +00001468 /* __coerce__ says "I can't do it" */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001469 Py_DECREF(coerced);
Guido van Rossum879c5811995-01-10 15:24:06 +00001470 return 1;
1471 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001472 if (!PyTuple_Check(coerced) || PyTuple_Size(coerced) != 2) {
Guido van Rossum879c5811995-01-10 15:24:06 +00001473 /* __coerce__ return value is malformed */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001474 Py_DECREF(coerced);
1475 PyErr_SetString(PyExc_TypeError,
Guido van Rossum879c5811995-01-10 15:24:06 +00001476 "coercion should return None or 2-tuple");
1477 return -1;
1478 }
1479 /* __coerce__ returned two new values */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001480 *pv = PyTuple_GetItem(coerced, 0);
1481 *pw = PyTuple_GetItem(coerced, 1);
1482 Py_INCREF(*pv);
1483 Py_INCREF(*pw);
1484 Py_DECREF(coerced);
Guido van Rossum879c5811995-01-10 15:24:06 +00001485 return 0;
1486}
1487
Guido van Rossum04691fc1992-08-12 15:35:34 +00001488#define UNARY(funcname, methodname) \
Thomas Woutersc3073522000-07-23 22:09:59 +00001489static PyObject *funcname(PyInstanceObject *self) { \
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001490 static PyObject *o; \
Guido van Rossuma412d241997-01-18 07:59:12 +00001491 if (o == NULL) o = PyString_InternFromString(methodname); \
Guido van Rossum2878a691996-08-09 20:53:24 +00001492 return generic_unary_op(self, o); \
Guido van Rossum04691fc1992-08-12 15:35:34 +00001493}
1494
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001495#define BINARY(f, m, n) \
1496static PyObject *f(PyObject *v, PyObject *w) { \
1497 return do_binop(v, w, "__" m "__", "__r" m "__", n); \
1498}
1499
1500#define BINARY_INPLACE(f, m, n) \
1501static PyObject *f(PyObject *v, PyObject *w) { \
1502 return do_binop_inplace(v, w, "__i" m "__", "__" m "__", \
1503 "__r" m "__", n); \
1504}
1505
Guido van Rossum04691fc1992-08-12 15:35:34 +00001506UNARY(instance_neg, "__neg__")
1507UNARY(instance_pos, "__pos__")
1508UNARY(instance_abs, "__abs__")
1509
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001510BINARY(instance_or, "or", PyNumber_Or)
1511BINARY(instance_and, "and", PyNumber_And)
1512BINARY(instance_xor, "xor", PyNumber_Xor)
1513BINARY(instance_lshift, "lshift", PyNumber_Lshift)
1514BINARY(instance_rshift, "rshift", PyNumber_Rshift)
1515BINARY(instance_add, "add", PyNumber_Add)
1516BINARY(instance_sub, "sub", PyNumber_Subtract)
1517BINARY(instance_mul, "mul", PyNumber_Multiply)
1518BINARY(instance_div, "div", PyNumber_Divide)
1519BINARY(instance_mod, "mod", PyNumber_Remainder)
1520BINARY(instance_divmod, "divmod", PyNumber_Divmod)
Guido van Rossum4668b002001-08-08 05:00:18 +00001521BINARY(instance_floordiv, "floordiv", PyNumber_FloorDivide)
1522BINARY(instance_truediv, "truediv", PyNumber_TrueDivide)
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001523
1524BINARY_INPLACE(instance_ior, "or", PyNumber_InPlaceOr)
1525BINARY_INPLACE(instance_ixor, "xor", PyNumber_InPlaceXor)
1526BINARY_INPLACE(instance_iand, "and", PyNumber_InPlaceAnd)
1527BINARY_INPLACE(instance_ilshift, "lshift", PyNumber_InPlaceLshift)
1528BINARY_INPLACE(instance_irshift, "rshift", PyNumber_InPlaceRshift)
1529BINARY_INPLACE(instance_iadd, "add", PyNumber_InPlaceAdd)
1530BINARY_INPLACE(instance_isub, "sub", PyNumber_InPlaceSubtract)
1531BINARY_INPLACE(instance_imul, "mul", PyNumber_InPlaceMultiply)
1532BINARY_INPLACE(instance_idiv, "div", PyNumber_InPlaceDivide)
1533BINARY_INPLACE(instance_imod, "mod", PyNumber_InPlaceRemainder)
Guido van Rossum4668b002001-08-08 05:00:18 +00001534BINARY_INPLACE(instance_ifloordiv, "floordiv", PyNumber_InPlaceFloorDivide)
1535BINARY_INPLACE(instance_itruediv, "truediv", PyNumber_InPlaceTrueDivide)
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001536
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001537/* Try a 3-way comparison, returning an int; v is an instance. Return:
1538 -2 for an exception;
1539 -1 if v < w;
1540 0 if v == w;
1541 1 if v > w;
1542 2 if this particular 3-way comparison is not implemented or undefined.
1543*/
1544static int
1545half_cmp(PyObject *v, PyObject *w)
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001546{
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001547 static PyObject *cmp_obj;
1548 PyObject *args;
Guido van Rossum3202c6f2001-01-29 23:50:25 +00001549 PyObject *cmp_func;
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001550 PyObject *result;
1551 long l;
1552
1553 assert(PyInstance_Check(v));
1554
1555 if (cmp_obj == NULL) {
1556 cmp_obj = PyString_InternFromString("__cmp__");
1557 if (cmp_obj == NULL)
1558 return -2;
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001559 }
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001560
Guido van Rossum3202c6f2001-01-29 23:50:25 +00001561 cmp_func = PyObject_GetAttr(v, cmp_obj);
1562 if (cmp_func == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001563 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1564 return -2;
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001565 PyErr_Clear();
1566 return 2;
1567 }
1568
1569 args = Py_BuildValue("(O)", w);
1570 if (args == NULL)
1571 return -2;
1572
Guido van Rossum3202c6f2001-01-29 23:50:25 +00001573 result = PyEval_CallObject(cmp_func, args);
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001574 Py_DECREF(args);
Guido van Rossum3202c6f2001-01-29 23:50:25 +00001575 Py_DECREF(cmp_func);
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001576
1577 if (result == NULL)
1578 return -2;
1579
1580 if (result == Py_NotImplemented) {
1581 Py_DECREF(result);
1582 return 2;
1583 }
1584
1585 l = PyInt_AsLong(result);
1586 Py_DECREF(result);
1587 if (l == -1 && PyErr_Occurred()) {
1588 PyErr_SetString(PyExc_TypeError,
1589 "comparison did not return an int");
1590 return -2;
1591 }
1592
1593 return l < 0 ? -1 : l > 0 ? 1 : 0;
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001594}
1595
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001596/* Try a 3-way comparison, returning an int; either v or w is an instance.
1597 We first try a coercion. Return:
1598 -2 for an exception;
1599 -1 if v < w;
1600 0 if v == w;
1601 1 if v > w;
1602 2 if this particular 3-way comparison is not implemented or undefined.
1603 THIS IS ONLY CALLED FROM object.c!
1604*/
1605static int
1606instance_compare(PyObject *v, PyObject *w)
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001607{
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001608 int c;
1609
1610 c = PyNumber_CoerceEx(&v, &w);
1611 if (c < 0)
1612 return -2;
1613 if (c == 0) {
1614 /* If neither is now an instance, use regular comparison */
1615 if (!PyInstance_Check(v) && !PyInstance_Check(w)) {
1616 c = PyObject_Compare(v, w);
1617 Py_DECREF(v);
1618 Py_DECREF(w);
1619 if (PyErr_Occurred())
1620 return -2;
1621 return c < 0 ? -1 : c > 0 ? 1 : 0;
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001622 }
1623 }
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001624 else {
1625 /* The coercion didn't do anything.
1626 Treat this the same as returning v and w unchanged. */
1627 Py_INCREF(v);
1628 Py_INCREF(w);
1629 }
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001630
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001631 if (PyInstance_Check(v)) {
1632 c = half_cmp(v, w);
1633 if (c <= 1) {
1634 Py_DECREF(v);
1635 Py_DECREF(w);
1636 return c;
1637 }
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001638 }
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001639 if (PyInstance_Check(w)) {
1640 c = half_cmp(w, v);
1641 if (c <= 1) {
1642 Py_DECREF(v);
1643 Py_DECREF(w);
1644 if (c >= -1)
1645 c = -c;
1646 return c;
1647 }
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001648 }
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001649 Py_DECREF(v);
1650 Py_DECREF(w);
1651 return 2;
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001652}
1653
Guido van Rossum9bfef441993-03-29 10:43:31 +00001654static int
Fred Drake79912472000-07-09 04:06:11 +00001655instance_nonzero(PyInstanceObject *self)
Guido van Rossum04691fc1992-08-12 15:35:34 +00001656{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001657 PyObject *func, *res;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001658 long outcome;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001659 static PyObject *nonzerostr;
Guido van Rossum04691fc1992-08-12 15:35:34 +00001660
Guido van Rossum2878a691996-08-09 20:53:24 +00001661 if (nonzerostr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001662 nonzerostr = PyString_InternFromString("__nonzero__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001663 if ((func = instance_getattr(self, nonzerostr)) == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001664 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1665 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001666 PyErr_Clear();
Guido van Rossum2878a691996-08-09 20:53:24 +00001667 if (lenstr == NULL)
Guido van Rossuma412d241997-01-18 07:59:12 +00001668 lenstr = PyString_InternFromString("__len__");
Guido van Rossum2878a691996-08-09 20:53:24 +00001669 if ((func = instance_getattr(self, lenstr)) == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001670 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1671 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001672 PyErr_Clear();
Guido van Rossum04691fc1992-08-12 15:35:34 +00001673 /* Fall back to the default behavior:
1674 all instances are nonzero */
1675 return 1;
1676 }
1677 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001678 res = PyEval_CallObject(func, (PyObject *)NULL);
1679 Py_DECREF(func);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001680 if (res == NULL)
1681 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001682 if (!PyInt_Check(res)) {
1683 Py_DECREF(res);
1684 PyErr_SetString(PyExc_TypeError,
1685 "__nonzero__ should return an int");
Guido van Rossum04691fc1992-08-12 15:35:34 +00001686 return -1;
1687 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001688 outcome = PyInt_AsLong(res);
1689 Py_DECREF(res);
Guido van Rossum04691fc1992-08-12 15:35:34 +00001690 if (outcome < 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001691 PyErr_SetString(PyExc_ValueError,
1692 "__nonzero__ should return >= 0");
Guido van Rossum04691fc1992-08-12 15:35:34 +00001693 return -1;
1694 }
1695 return outcome > 0;
1696}
1697
1698UNARY(instance_invert, "__invert__")
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001699UNARY(instance_int, "__int__")
1700UNARY(instance_long, "__long__")
1701UNARY(instance_float, "__float__")
1702UNARY(instance_oct, "__oct__")
1703UNARY(instance_hex, "__hex__")
1704
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001705static PyObject *
1706bin_power(PyObject *v, PyObject *w)
1707{
1708 return PyNumber_Power(v, w, Py_None);
1709}
1710
Guido van Rossum03093a21994-09-28 15:51:32 +00001711/* This version is for ternary calls only (z != None) */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001712static PyObject *
Fred Drake79912472000-07-09 04:06:11 +00001713instance_pow(PyObject *v, PyObject *w, PyObject *z)
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001714{
1715 if (z == Py_None) {
1716 return do_binop(v, w, "__pow__", "__rpow__", bin_power);
Guido van Rossum03093a21994-09-28 15:51:32 +00001717 }
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001718 else {
1719 PyObject *func;
1720 PyObject *args;
1721 PyObject *result;
1722
1723 /* XXX Doesn't do coercions... */
1724 func = PyObject_GetAttrString(v, "__pow__");
1725 if (func == NULL)
1726 return NULL;
1727 args = Py_BuildValue("(OO)", w, z);
1728 if (args == NULL) {
1729 Py_DECREF(func);
1730 return NULL;
1731 }
1732 result = PyEval_CallObject(func, args);
1733 Py_DECREF(func);
1734 Py_DECREF(args);
1735 return result;
1736 }
Guido van Rossum03093a21994-09-28 15:51:32 +00001737}
1738
Thomas Wouterse289e0b2000-08-24 20:08:19 +00001739static PyObject *
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001740bin_inplace_power(PyObject *v, PyObject *w)
Thomas Wouterse289e0b2000-08-24 20:08:19 +00001741{
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001742 return PyNumber_InPlacePower(v, w, Py_None);
Thomas Wouterse289e0b2000-08-24 20:08:19 +00001743}
1744
1745
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001746static PyObject *
1747instance_ipow(PyObject *v, PyObject *w, PyObject *z)
1748{
1749 if (z == Py_None) {
1750 return do_binop_inplace(v, w, "__ipow__", "__pow__",
1751 "__rpow__", bin_inplace_power);
1752 }
1753 else {
1754 /* XXX Doesn't do coercions... */
1755 PyObject *func;
1756 PyObject *args;
1757 PyObject *result;
1758
1759 func = PyObject_GetAttrString(v, "__ipow__");
1760 if (func == NULL) {
1761 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1762 return NULL;
1763 PyErr_Clear();
1764 return instance_pow(v, w, z);
1765 }
1766 args = Py_BuildValue("(OO)", w, z);
1767 if (args == NULL) {
1768 Py_DECREF(func);
1769 return NULL;
1770 }
1771 result = PyEval_CallObject(func, args);
1772 Py_DECREF(func);
1773 Py_DECREF(args);
1774 return result;
1775 }
1776}
1777
1778
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001779/* Map rich comparison operators to their __xx__ namesakes */
Jeremy Hylton1b0feb42001-05-11 14:48:41 +00001780#define NAME_OPS 6
1781static PyObject **name_op = NULL;
1782
1783static int
Guido van Rossum0ba9e3a2001-05-22 02:33:08 +00001784init_name_op(void)
Jeremy Hylton1b0feb42001-05-11 14:48:41 +00001785{
1786 int i;
1787 char *_name_op[] = {
1788 "__lt__",
1789 "__le__",
1790 "__eq__",
1791 "__ne__",
1792 "__gt__",
1793 "__ge__",
1794 };
1795
1796 name_op = (PyObject **)malloc(sizeof(PyObject *) * NAME_OPS);
1797 if (name_op == NULL)
1798 return -1;
1799 for (i = 0; i < NAME_OPS; ++i) {
1800 name_op[i] = PyString_InternFromString(_name_op[i]);
1801 if (name_op[i] == NULL)
1802 return -1;
1803 }
1804 return 0;
1805}
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001806
1807static PyObject *
1808half_richcompare(PyObject *v, PyObject *w, int op)
1809{
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001810 PyObject *method;
1811 PyObject *args;
1812 PyObject *res;
1813
1814 assert(PyInstance_Check(v));
1815
Jeremy Hylton1b0feb42001-05-11 14:48:41 +00001816 if (name_op == NULL) {
1817 if (init_name_op() < 0)
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001818 return NULL;
Jeremy Hylton1b0feb42001-05-11 14:48:41 +00001819 }
1820 /* If the instance doesn't define an __getattr__ method, use
1821 instance_getattr2 directly because it will not set an
1822 exception on failure. */
1823 if (((PyInstanceObject *)v)->in_class->cl_getattr == NULL) {
1824 method = instance_getattr2((PyInstanceObject *)v,
1825 name_op[op]);
1826 if (method == NULL) {
1827 assert(!PyErr_Occurred());
1828 res = Py_NotImplemented;
1829 Py_INCREF(res);
1830 return res;
1831 }
1832 } else {
1833 method = PyObject_GetAttr(v, name_op[op]);
1834 if (method == NULL) {
1835 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1836 return NULL;
1837 PyErr_Clear();
1838 res = Py_NotImplemented;
1839 Py_INCREF(res);
1840 return res;
1841 }
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001842 }
1843
1844 args = Py_BuildValue("(O)", w);
1845 if (args == NULL) {
1846 Py_DECREF(method);
1847 return NULL;
1848 }
1849
1850 res = PyEval_CallObject(method, args);
1851 Py_DECREF(args);
1852 Py_DECREF(method);
1853
1854 return res;
1855}
1856
1857/* Map rich comparison operators to their swapped version, e.g. LT --> GT */
1858static int swapped_op[] = {Py_GT, Py_GE, Py_EQ, Py_NE, Py_LT, Py_LE};
1859
1860static PyObject *
1861instance_richcompare(PyObject *v, PyObject *w, int op)
1862{
1863 PyObject *res;
1864
1865 if (PyInstance_Check(v)) {
1866 res = half_richcompare(v, w, op);
1867 if (res != Py_NotImplemented)
1868 return res;
1869 Py_DECREF(res);
1870 }
1871
1872 if (PyInstance_Check(w)) {
1873 res = half_richcompare(w, v, swapped_op[op]);
1874 if (res != Py_NotImplemented)
1875 return res;
1876 Py_DECREF(res);
1877 }
1878
1879 Py_INCREF(Py_NotImplemented);
1880 return Py_NotImplemented;
1881}
1882
Neil Schemenauer29bfc072001-01-04 01:43:46 +00001883
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001884/* Get the iterator */
1885static PyObject *
1886instance_getiter(PyInstanceObject *self)
1887{
1888 PyObject *func;
1889
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001890 if (iterstr == NULL) {
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001891 iterstr = PyString_InternFromString("__iter__");
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001892 if (iterstr == NULL)
1893 return NULL;
1894 }
1895 if (getitemstr == NULL) {
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001896 getitemstr = PyString_InternFromString("__getitem__");
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001897 if (getitemstr == NULL)
1898 return NULL;
1899 }
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001900
1901 if ((func = instance_getattr(self, iterstr)) != NULL) {
1902 PyObject *res = PyEval_CallObject(func, (PyObject *)NULL);
1903 Py_DECREF(func);
Guido van Rossum213c7a62001-04-23 14:08:49 +00001904 if (res != NULL && !PyIter_Check(res)) {
1905 PyErr_Format(PyExc_TypeError,
1906 "__iter__ returned non-iterator "
1907 "of type '%.100s'",
1908 res->ob_type->tp_name);
1909 Py_DECREF(res);
1910 res = NULL;
1911 }
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001912 return res;
1913 }
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001914 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1915 return NULL;
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001916 PyErr_Clear();
1917 if ((func = instance_getattr(self, getitemstr)) == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001918 PyErr_SetString(PyExc_TypeError,
1919 "iteration over non-sequence");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001920 return NULL;
1921 }
1922 Py_DECREF(func);
Guido van Rossum213c7a62001-04-23 14:08:49 +00001923 return PySeqIter_New((PyObject *)self);
1924}
1925
1926
1927/* Call the iterator's next */
1928static PyObject *
1929instance_iternext(PyInstanceObject *self)
1930{
1931 PyObject *func;
1932
1933 if (nextstr == NULL)
1934 nextstr = PyString_InternFromString("next");
1935
1936 if ((func = instance_getattr(self, nextstr)) != NULL) {
1937 PyObject *res = PyEval_CallObject(func, (PyObject *)NULL);
1938 Py_DECREF(func);
1939 if (res != NULL) {
1940 return res;
1941 }
1942 if (PyErr_ExceptionMatches(PyExc_StopIteration)) {
1943 PyErr_Clear();
1944 return NULL;
1945 }
1946 return NULL;
1947 }
1948 PyErr_SetString(PyExc_TypeError, "instance has no next() method");
1949 return NULL;
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001950}
1951
Tim Peters6d6c1a32001-08-02 04:15:00 +00001952static PyObject *
1953instance_call(PyObject *func, PyObject *arg, PyObject *kw)
1954{
Guido van Rossum16b93b32002-06-13 21:32:51 +00001955 PyThreadState *tstate = PyThreadState_GET();
Tim Peters6d6c1a32001-08-02 04:15:00 +00001956 PyObject *res, *call = PyObject_GetAttrString(func, "__call__");
1957 if (call == NULL) {
1958 PyInstanceObject *inst = (PyInstanceObject*) func;
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00001959 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
1960 return NULL;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001961 PyErr_Clear();
1962 PyErr_Format(PyExc_AttributeError,
1963 "%.200s instance has no __call__ method",
1964 PyString_AsString(inst->in_class->cl_name));
1965 return NULL;
1966 }
Guido van Rossum16b93b32002-06-13 21:32:51 +00001967 /* We must check and increment the recursion depth here. Scenario:
1968 class A:
1969 pass
1970 A.__call__ = A() # that's right
1971 a = A() # ok
1972 a() # infinite recursion
1973 This bounces between instance_call() and PyObject_Call() without
1974 ever hitting eval_frame() (which has the main recursion check). */
1975 if (tstate->recursion_depth++ > Py_GetRecursionLimit()) {
1976 PyErr_SetString(PyExc_RuntimeError,
1977 "maximum __call__ recursion depth exceeded");
1978 res = NULL;
1979 }
1980 else
1981 res = PyObject_Call(call, arg, kw);
1982 tstate->recursion_depth--;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001983 Py_DECREF(call);
1984 return res;
1985}
1986
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001987
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001988static PyNumberMethods instance_as_number = {
Guido van Rossum8998b4f2001-01-17 15:28:20 +00001989 (binaryfunc)instance_add, /* nb_add */
1990 (binaryfunc)instance_sub, /* nb_subtract */
1991 (binaryfunc)instance_mul, /* nb_multiply */
1992 (binaryfunc)instance_div, /* nb_divide */
1993 (binaryfunc)instance_mod, /* nb_remainder */
1994 (binaryfunc)instance_divmod, /* nb_divmod */
1995 (ternaryfunc)instance_pow, /* nb_power */
1996 (unaryfunc)instance_neg, /* nb_negative */
1997 (unaryfunc)instance_pos, /* nb_positive */
1998 (unaryfunc)instance_abs, /* nb_absolute */
1999 (inquiry)instance_nonzero, /* nb_nonzero */
2000 (unaryfunc)instance_invert, /* nb_invert */
2001 (binaryfunc)instance_lshift, /* nb_lshift */
2002 (binaryfunc)instance_rshift, /* nb_rshift */
2003 (binaryfunc)instance_and, /* nb_and */
2004 (binaryfunc)instance_xor, /* nb_xor */
2005 (binaryfunc)instance_or, /* nb_or */
2006 (coercion)instance_coerce, /* nb_coerce */
2007 (unaryfunc)instance_int, /* nb_int */
2008 (unaryfunc)instance_long, /* nb_long */
2009 (unaryfunc)instance_float, /* nb_float */
2010 (unaryfunc)instance_oct, /* nb_oct */
2011 (unaryfunc)instance_hex, /* nb_hex */
2012 (binaryfunc)instance_iadd, /* nb_inplace_add */
2013 (binaryfunc)instance_isub, /* nb_inplace_subtract */
2014 (binaryfunc)instance_imul, /* nb_inplace_multiply */
2015 (binaryfunc)instance_idiv, /* nb_inplace_divide */
2016 (binaryfunc)instance_imod, /* nb_inplace_remainder */
2017 (ternaryfunc)instance_ipow, /* nb_inplace_power */
2018 (binaryfunc)instance_ilshift, /* nb_inplace_lshift */
2019 (binaryfunc)instance_irshift, /* nb_inplace_rshift */
2020 (binaryfunc)instance_iand, /* nb_inplace_and */
2021 (binaryfunc)instance_ixor, /* nb_inplace_xor */
2022 (binaryfunc)instance_ior, /* nb_inplace_or */
Guido van Rossum4668b002001-08-08 05:00:18 +00002023 (binaryfunc)instance_floordiv, /* nb_floor_divide */
2024 (binaryfunc)instance_truediv, /* nb_true_divide */
2025 (binaryfunc)instance_ifloordiv, /* nb_inplace_floor_divide */
2026 (binaryfunc)instance_itruediv, /* nb_inplace_true_divide */
Guido van Rossum04691fc1992-08-12 15:35:34 +00002027};
2028
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002029PyTypeObject PyInstance_Type = {
2030 PyObject_HEAD_INIT(&PyType_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002031 0,
Guido van Rossum21ed88c1991-04-04 10:42:10 +00002032 "instance",
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002033 sizeof(PyInstanceObject),
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002034 0,
Guido van Rossum8998b4f2001-01-17 15:28:20 +00002035 (destructor)instance_dealloc, /* tp_dealloc */
2036 0, /* tp_print */
2037 0, /* tp_getattr */
2038 0, /* tp_setattr */
2039 instance_compare, /* tp_compare */
2040 (reprfunc)instance_repr, /* tp_repr */
2041 &instance_as_number, /* tp_as_number */
2042 &instance_as_sequence, /* tp_as_sequence */
2043 &instance_as_mapping, /* tp_as_mapping */
2044 (hashfunc)instance_hash, /* tp_hash */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002045 instance_call, /* tp_call */
Guido van Rossum82c690f2001-04-30 14:39:18 +00002046 (reprfunc)instance_str, /* tp_str */
Guido van Rossum8998b4f2001-01-17 15:28:20 +00002047 (getattrofunc)instance_getattr, /* tp_getattro */
2048 (setattrofunc)instance_setattr, /* tp_setattro */
2049 0, /* tp_as_buffer */
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002050 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC | Py_TPFLAGS_CHECKTYPES,/*tp_flags*/
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002051 instance_doc, /* tp_doc */
Jeremy Hylton8caad492000-06-23 14:18:11 +00002052 (traverseproc)instance_traverse, /* tp_traverse */
Guido van Rossum8998b4f2001-01-17 15:28:20 +00002053 0, /* tp_clear */
2054 instance_richcompare, /* tp_richcompare */
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00002055 offsetof(PyInstanceObject, in_weakreflist), /* tp_weaklistoffset */
2056 (getiterfunc)instance_getiter, /* tp_iter */
Guido van Rossum213c7a62001-04-23 14:08:49 +00002057 (iternextfunc)instance_iternext, /* tp_iternext */
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002058 0, /* tp_methods */
2059 0, /* tp_members */
2060 0, /* tp_getset */
2061 0, /* tp_base */
2062 0, /* tp_dict */
2063 0, /* tp_descr_get */
2064 0, /* tp_descr_set */
2065 0, /* tp_dictoffset */
2066 0, /* tp_init */
2067 0, /* tp_alloc */
2068 instance_new, /* tp_new */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002069};
2070
2071
Guido van Rossum81daa321993-05-20 14:24:46 +00002072/* Instance method objects are used for two purposes:
2073 (a) as bound instance methods (returned by instancename.methodname)
2074 (b) as unbound methods (returned by ClassName.methodname)
2075 In case (b), im_self is NULL
2076*/
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002077
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002078static PyMethodObject *free_list;
2079
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002080PyObject *
Fred Drake79912472000-07-09 04:06:11 +00002081PyMethod_New(PyObject *func, PyObject *self, PyObject *class)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002082{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002083 register PyMethodObject *im;
Guido van Rossum7859f871998-07-08 14:58:16 +00002084 if (!PyCallable_Check(func)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002085 PyErr_BadInternalCall();
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002086 return NULL;
2087 }
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002088 im = free_list;
2089 if (im != NULL) {
2090 free_list = (PyMethodObject *)(im->im_self);
Guido van Rossumb18618d2000-05-03 23:44:39 +00002091 PyObject_INIT(im, &PyMethod_Type);
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002092 }
2093 else {
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002094 im = PyObject_GC_New(PyMethodObject, &PyMethod_Type);
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002095 if (im == NULL)
2096 return NULL;
2097 }
Fred Drakedb81e8d2001-03-23 04:19:27 +00002098 im->im_weakreflist = NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002099 Py_INCREF(func);
Guido van Rossume8122f11991-05-05 20:03:07 +00002100 im->im_func = func;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002101 Py_XINCREF(self);
Guido van Rossume8122f11991-05-05 20:03:07 +00002102 im->im_self = self;
Guido van Rossumcdf0d752001-08-17 12:07:34 +00002103 Py_XINCREF(class);
Guido van Rossum81daa321993-05-20 14:24:46 +00002104 im->im_class = class;
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002105 _PyObject_GC_TRACK(im);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002106 return (PyObject *)im;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002107}
2108
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002109/* Descriptors for PyMethod attributes */
2110
2111/* im_class, im_func and im_self are stored in the PyMethod object */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002112
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002113#define OFF(x) offsetof(PyMethodObject, x)
Guido van Rossum3f5da241990-12-20 15:06:42 +00002114
Guido van Rossum6f799372001-09-20 20:46:19 +00002115static PyMemberDef instancemethod_memberlist[] = {
2116 {"im_class", T_OBJECT, OFF(im_class), READONLY|RESTRICTED,
2117 "the class associated with a method"},
2118 {"im_func", T_OBJECT, OFF(im_func), READONLY|RESTRICTED,
2119 "the function (or other callable) implementing a method"},
2120 {"im_self", T_OBJECT, OFF(im_self), READONLY|RESTRICTED,
2121 "the instance to which a method is bound; None for unbound methods"},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002122 {NULL} /* Sentinel */
2123};
2124
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002125/* The getattr() implementation for PyMethod objects is similar to
2126 PyObject_GenericGetAttr(), but instead of looking in __dict__ it
2127 asks im_self for the attribute. Then the error handling is a bit
2128 different because we want to preserve the exception raised by the
2129 delegate, unless we have an alternative from our class. */
2130
2131static PyObject *
2132instancemethod_getattro(PyObject *obj, PyObject *name)
2133{
2134 PyMethodObject *im = (PyMethodObject *)obj;
2135 PyTypeObject *tp = obj->ob_type;
Guido van Rossum915f0eb2001-10-17 20:26:38 +00002136 PyObject *descr = NULL, *res;
2137 descrgetfunc f = NULL;
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002138
Guido van Rossum915f0eb2001-10-17 20:26:38 +00002139 if (PyType_HasFeature(tp, Py_TPFLAGS_HAVE_CLASS)) {
2140 if (tp->tp_dict == NULL) {
2141 if (PyType_Ready(tp) < 0)
2142 return NULL;
2143 }
2144 descr = _PyType_Lookup(tp, name);
Barry Warsawd6a9e842001-01-15 20:40:19 +00002145 }
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002146
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002147 f = NULL;
2148 if (descr != NULL) {
Guido van Rossum915f0eb2001-10-17 20:26:38 +00002149 f = TP_DESCR_GET(descr->ob_type);
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002150 if (f != NULL && PyDescr_IsData(descr))
2151 return f(descr, obj, (PyObject *)obj->ob_type);
2152 }
2153
2154 res = PyObject_GetAttr(im->im_func, name);
2155 if (res != NULL || !PyErr_ExceptionMatches(PyExc_AttributeError))
2156 return res;
2157
2158 if (f != NULL) {
2159 PyErr_Clear();
2160 return f(descr, obj, (PyObject *)obj->ob_type);
2161 }
2162
2163 if (descr != NULL) {
2164 PyErr_Clear();
2165 Py_INCREF(descr);
2166 return descr;
2167 }
2168
2169 assert(PyErr_Occurred());
2170 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00002171}
2172
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002173PyDoc_STRVAR(instancemethod_doc,
2174"instancemethod(function, instance, class)\n\
2175\n\
2176Create an instance method object.");
2177
2178static PyObject *
2179instancemethod_new(PyTypeObject* type, PyObject* args, PyObject *kw)
2180{
2181 PyObject *func;
2182 PyObject *self;
2183 PyObject *classObj;
2184
2185 if (!PyArg_ParseTuple(args, "OOO:instancemethod",
2186 &func, &self, &classObj))
2187 return NULL;
2188 if (!PyCallable_Check(func)) {
2189 PyErr_SetString(PyExc_TypeError,
2190 "first argument must be callable");
2191 return NULL;
2192 }
2193 if (self == Py_None)
2194 self = NULL;
2195 return PyMethod_New(func, self, classObj);
2196}
2197
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002198static void
Fred Drake79912472000-07-09 04:06:11 +00002199instancemethod_dealloc(register PyMethodObject *im)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002200{
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002201 _PyObject_GC_UNTRACK(im);
Fred Drakec916f5a2001-10-26 17:56:51 +00002202 if (im->im_weakreflist != NULL)
2203 PyObject_ClearWeakRefs((PyObject *)im);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002204 Py_DECREF(im->im_func);
2205 Py_XDECREF(im->im_self);
Guido van Rossumcdf0d752001-08-17 12:07:34 +00002206 Py_XDECREF(im->im_class);
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002207 im->im_self = (PyObject *)free_list;
2208 free_list = im;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002209}
2210
Guido van Rossumebc8c511992-09-03 20:39:51 +00002211static int
Fred Drake79912472000-07-09 04:06:11 +00002212instancemethod_compare(PyMethodObject *a, PyMethodObject *b)
Guido van Rossumebc8c511992-09-03 20:39:51 +00002213{
Guido van Rossume9df7271995-04-06 14:46:51 +00002214 if (a->im_self != b->im_self)
2215 return (a->im_self < b->im_self) ? -1 : 1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002216 return PyObject_Compare(a->im_func, b->im_func);
Guido van Rossumebc8c511992-09-03 20:39:51 +00002217}
2218
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002219static PyObject *
Fred Drake79912472000-07-09 04:06:11 +00002220instancemethod_repr(PyMethodObject *a)
Guido van Rossum25831651993-05-19 14:50:45 +00002221{
Tim Peters6d6c1a32001-08-02 04:15:00 +00002222 PyObject *self = a->im_self;
Guido van Rossum7859f871998-07-08 14:58:16 +00002223 PyObject *func = a->im_func;
Tim Peters6d6c1a32001-08-02 04:15:00 +00002224 PyObject *klass = a->im_class;
2225 PyObject *funcname = NULL, *klassname = NULL, *result = NULL;
2226 char *sfuncname = "?", *sklassname = "?";
2227
2228 funcname = PyObject_GetAttrString(func, "__name__");
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00002229 if (funcname == NULL) {
2230 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
2231 return NULL;
Tim Peters6d6c1a32001-08-02 04:15:00 +00002232 PyErr_Clear();
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00002233 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00002234 else if (!PyString_Check(funcname)) {
2235 Py_DECREF(funcname);
2236 funcname = NULL;
Guido van Rossum7859f871998-07-08 14:58:16 +00002237 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00002238 else
2239 sfuncname = PyString_AS_STRING(funcname);
Guido van Rossum40667692001-08-17 13:59:27 +00002240 if (klass == NULL)
Tim Peters6d6c1a32001-08-02 04:15:00 +00002241 klassname = NULL;
Guido van Rossum40667692001-08-17 13:59:27 +00002242 else {
2243 klassname = PyObject_GetAttrString(klass, "__name__");
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00002244 if (klassname == NULL) {
2245 if (!PyErr_ExceptionMatches(PyExc_AttributeError))
2246 return NULL;
Guido van Rossum40667692001-08-17 13:59:27 +00002247 PyErr_Clear();
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00002248 }
Guido van Rossum40667692001-08-17 13:59:27 +00002249 else if (!PyString_Check(klassname)) {
2250 Py_DECREF(klassname);
2251 klassname = NULL;
2252 }
2253 else
2254 sklassname = PyString_AS_STRING(klassname);
Guido van Rossum7859f871998-07-08 14:58:16 +00002255 }
Guido van Rossum81daa321993-05-20 14:24:46 +00002256 if (self == NULL)
Barry Warsaw7ce36942001-08-24 18:34:26 +00002257 result = PyString_FromFormat("<unbound method %s.%s>",
2258 sklassname, sfuncname);
Guido van Rossum81daa321993-05-20 14:24:46 +00002259 else {
Tim Peters6d6c1a32001-08-02 04:15:00 +00002260 /* XXX Shouldn't use repr() here! */
2261 PyObject *selfrepr = PyObject_Repr(self);
2262 if (selfrepr == NULL)
2263 goto fail;
2264 if (!PyString_Check(selfrepr)) {
2265 Py_DECREF(selfrepr);
2266 goto fail;
2267 }
Barry Warsaw7ce36942001-08-24 18:34:26 +00002268 result = PyString_FromFormat("<bound method %s.%s of %s>",
2269 sklassname, sfuncname,
2270 PyString_AS_STRING(selfrepr));
Tim Peters6d6c1a32001-08-02 04:15:00 +00002271 Py_DECREF(selfrepr);
Guido van Rossum81daa321993-05-20 14:24:46 +00002272 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00002273 fail:
Guido van Rossum42636dc1999-10-11 14:03:12 +00002274 Py_XDECREF(funcname);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002275 Py_XDECREF(klassname);
2276 return result;
Guido van Rossum25831651993-05-19 14:50:45 +00002277}
2278
Guido van Rossum9bfef441993-03-29 10:43:31 +00002279static long
Fred Drake79912472000-07-09 04:06:11 +00002280instancemethod_hash(PyMethodObject *a)
Guido van Rossum9bfef441993-03-29 10:43:31 +00002281{
2282 long x, y;
Guido van Rossum81daa321993-05-20 14:24:46 +00002283 if (a->im_self == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002284 x = PyObject_Hash(Py_None);
Guido van Rossum81daa321993-05-20 14:24:46 +00002285 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002286 x = PyObject_Hash(a->im_self);
Guido van Rossum9bfef441993-03-29 10:43:31 +00002287 if (x == -1)
2288 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002289 y = PyObject_Hash(a->im_func);
Guido van Rossum9bfef441993-03-29 10:43:31 +00002290 if (y == -1)
2291 return -1;
2292 return x ^ y;
2293}
2294
Jeremy Hylton8caad492000-06-23 14:18:11 +00002295static int
2296instancemethod_traverse(PyMethodObject *im, visitproc visit, void *arg)
2297{
2298 int err;
2299 if (im->im_func) {
2300 err = visit(im->im_func, arg);
2301 if (err)
2302 return err;
2303 }
2304 if (im->im_self) {
2305 err = visit(im->im_self, arg);
2306 if (err)
2307 return err;
2308 }
2309 if (im->im_class) {
2310 err = visit(im->im_class, arg);
2311 if (err)
2312 return err;
2313 }
Jeremy Hyltond22162b2000-06-23 17:14:56 +00002314 return 0;
Jeremy Hylton8caad492000-06-23 14:18:11 +00002315}
2316
Guido van Rossuma15dece2001-08-24 18:48:27 +00002317static char *
2318getclassname(PyObject *class)
2319{
2320 PyObject *name;
2321
2322 if (class == NULL)
2323 name = NULL;
2324 else
2325 name = PyObject_GetAttrString(class, "__name__");
2326 if (name == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00002327 /* This function cannot return an exception */
Guido van Rossuma15dece2001-08-24 18:48:27 +00002328 PyErr_Clear();
2329 return "?";
2330 }
2331 if (!PyString_Check(name)) {
2332 Py_DECREF(name);
2333 return "?";
2334 }
2335 PyString_InternInPlace(&name);
2336 Py_DECREF(name);
2337 return PyString_AS_STRING(name);
2338}
2339
2340static char *
2341getinstclassname(PyObject *inst)
2342{
2343 PyObject *class;
2344 char *name;
2345
2346 if (inst == NULL)
2347 return "nothing";
2348
2349 class = PyObject_GetAttrString(inst, "__class__");
2350 if (class == NULL) {
Guido van Rossume7b8ecf2002-06-13 21:42:04 +00002351 /* This function cannot return an exception */
Guido van Rossuma15dece2001-08-24 18:48:27 +00002352 PyErr_Clear();
2353 class = (PyObject *)(inst->ob_type);
2354 Py_INCREF(class);
2355 }
2356 name = getclassname(class);
2357 Py_XDECREF(class);
2358 return name;
2359}
2360
Tim Peters6d6c1a32001-08-02 04:15:00 +00002361static PyObject *
2362instancemethod_call(PyObject *func, PyObject *arg, PyObject *kw)
2363{
2364 PyObject *self = PyMethod_GET_SELF(func);
2365 PyObject *class = PyMethod_GET_CLASS(func);
2366 PyObject *result;
2367
2368 func = PyMethod_GET_FUNCTION(func);
2369 if (self == NULL) {
2370 /* Unbound methods must be called with an instance of
2371 the class (or a derived class) as first argument */
2372 int ok;
2373 if (PyTuple_Size(arg) >= 1)
2374 self = PyTuple_GET_ITEM(arg, 0);
2375 if (self == NULL)
2376 ok = 0;
2377 else {
2378 ok = PyObject_IsInstance(self, class);
2379 if (ok < 0)
2380 return NULL;
2381 }
2382 if (!ok) {
2383 PyErr_Format(PyExc_TypeError,
Guido van Rossuma15dece2001-08-24 18:48:27 +00002384 "unbound method %s%s must be called with "
2385 "%s instance as first argument "
2386 "(got %s%s instead)",
Tim Peters6d6c1a32001-08-02 04:15:00 +00002387 PyEval_GetFuncName(func),
Guido van Rossuma15dece2001-08-24 18:48:27 +00002388 PyEval_GetFuncDesc(func),
2389 getclassname(class),
2390 getinstclassname(self),
2391 self == NULL ? "" : " instance");
Tim Peters6d6c1a32001-08-02 04:15:00 +00002392 return NULL;
2393 }
2394 Py_INCREF(arg);
2395 }
2396 else {
2397 int argcount = PyTuple_Size(arg);
2398 PyObject *newarg = PyTuple_New(argcount + 1);
2399 int i;
2400 if (newarg == NULL)
2401 return NULL;
2402 Py_INCREF(self);
2403 PyTuple_SET_ITEM(newarg, 0, self);
2404 for (i = 0; i < argcount; i++) {
2405 PyObject *v = PyTuple_GET_ITEM(arg, i);
2406 Py_XINCREF(v);
2407 PyTuple_SET_ITEM(newarg, i+1, v);
2408 }
2409 arg = newarg;
2410 }
2411 result = PyObject_Call((PyObject *)func, arg, kw);
2412 Py_DECREF(arg);
2413 return result;
2414}
2415
Guido van Rossum23cc2b42001-08-15 17:52:31 +00002416static PyObject *
Guido van Rossumf23c41d2001-08-17 13:43:27 +00002417instancemethod_descr_get(PyObject *meth, PyObject *obj, PyObject *class)
Guido van Rossum23cc2b42001-08-15 17:52:31 +00002418{
Guido van Rossumf23c41d2001-08-17 13:43:27 +00002419 /* Don't rebind an already bound method, or an unbound method
2420 of a class that's not a base class of class */
2421 if (PyMethod_GET_SELF(meth) != NULL ||
2422 (PyMethod_GET_CLASS(meth) != NULL &&
2423 !PyObject_IsSubclass(class, PyMethod_GET_CLASS(meth)))) {
Guido van Rossum501c7c72001-08-16 20:41:56 +00002424 Py_INCREF(meth);
2425 return meth;
2426 }
Guido van Rossum23cc2b42001-08-15 17:52:31 +00002427 if (obj == Py_None)
2428 obj = NULL;
Guido van Rossumf23c41d2001-08-17 13:43:27 +00002429 return PyMethod_New(PyMethod_GET_FUNCTION(meth), obj, class);
Guido van Rossum23cc2b42001-08-15 17:52:31 +00002430}
2431
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002432PyTypeObject PyMethod_Type = {
2433 PyObject_HEAD_INIT(&PyType_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002434 0,
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002435 "instancemethod",
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002436 sizeof(PyMethodObject),
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002437 0,
Guido van Rossum8998b4f2001-01-17 15:28:20 +00002438 (destructor)instancemethod_dealloc, /* tp_dealloc */
2439 0, /* tp_print */
2440 0, /* tp_getattr */
2441 0, /* tp_setattr */
2442 (cmpfunc)instancemethod_compare, /* tp_compare */
2443 (reprfunc)instancemethod_repr, /* tp_repr */
2444 0, /* tp_as_number */
2445 0, /* tp_as_sequence */
2446 0, /* tp_as_mapping */
2447 (hashfunc)instancemethod_hash, /* tp_hash */
Tim Peters6d6c1a32001-08-02 04:15:00 +00002448 instancemethod_call, /* tp_call */
Guido van Rossum8998b4f2001-01-17 15:28:20 +00002449 0, /* tp_str */
2450 (getattrofunc)instancemethod_getattro, /* tp_getattro */
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002451 PyObject_GenericSetAttr, /* tp_setattro */
Guido van Rossum8998b4f2001-01-17 15:28:20 +00002452 0, /* tp_as_buffer */
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002453 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC,/* tp_flags */
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002454 instancemethod_doc, /* tp_doc */
Jeremy Hylton8caad492000-06-23 14:18:11 +00002455 (traverseproc)instancemethod_traverse, /* tp_traverse */
Fred Drakedb81e8d2001-03-23 04:19:27 +00002456 0, /* tp_clear */
2457 0, /* tp_richcompare */
Guido van Rossum23cc2b42001-08-15 17:52:31 +00002458 offsetof(PyMethodObject, im_weakreflist), /* tp_weaklistoffset */
2459 0, /* tp_iter */
2460 0, /* tp_iternext */
2461 0, /* tp_methods */
Guido van Rossumf0b35e12001-09-18 03:53:24 +00002462 instancemethod_memberlist, /* tp_members */
Guido van Rossum56ff3872001-10-22 02:00:09 +00002463 0, /* tp_getset */
Guido van Rossum23cc2b42001-08-15 17:52:31 +00002464 0, /* tp_base */
2465 0, /* tp_dict */
2466 instancemethod_descr_get, /* tp_descr_get */
2467 0, /* tp_descr_set */
2468 0, /* tp_dictoffset */
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002469 0, /* tp_init */
2470 0, /* tp_alloc */
2471 instancemethod_new, /* tp_new */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002472};
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002473
2474/* Clear out the free list */
2475
2476void
Fred Drake79912472000-07-09 04:06:11 +00002477PyMethod_Fini(void)
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002478{
2479 while (free_list) {
Guido van Rossumb18618d2000-05-03 23:44:39 +00002480 PyMethodObject *im = free_list;
2481 free_list = (PyMethodObject *)(im->im_self);
Neil Schemenauere83c00e2001-08-29 23:54:21 +00002482 PyObject_GC_Del(im);
Guido van Rossuma0d349f1997-08-05 02:06:53 +00002483 }
2484}