blob: 323ed54b51b2342a9ae6ae3e1496e18be4ff4da6 [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum3f5da241990-12-20 15:06:42 +00002/* Generic object operations; and implementation of None (NoObject) */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00003
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004#include "Python.h"
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00005
Jack Jansen28fc8802000-07-11 21:47:20 +00006#ifdef macintosh
7#include "macglue.h"
8#endif
9
Guido van Rossume92e6102000-04-24 15:40:53 +000010/* just for trashcan: */
11#include "compile.h"
12#include "frameobject.h"
13#include "traceback.h"
14
Guido van Rossum6f9e4331995-03-29 16:57:48 +000015#if defined( Py_TRACE_REFS ) || defined( Py_REF_DEBUG )
Guido van Rossumbffd6832000-01-20 22:32:56 +000016DL_IMPORT(long) _Py_RefTotal;
Guido van Rossum3f5da241990-12-20 15:06:42 +000017#endif
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000018
Guido van Rossum3f5da241990-12-20 15:06:42 +000019/* Object allocation routines used by NEWOBJ and NEWVAROBJ macros.
20 These are used by the individual routines for object creation.
21 Do not call them otherwise, they do not initialize the object! */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000022
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000023#ifdef COUNT_ALLOCS
Guido van Rossumc0b618a1997-05-02 03:12:38 +000024static PyTypeObject *type_list;
Sjoerd Mullender842d2cc1993-10-15 16:18:48 +000025extern int tuple_zero_allocs, fast_tuple_allocs;
26extern int quick_int_allocs, quick_neg_int_allocs;
Sjoerd Mullender3bb8a051993-10-22 12:04:32 +000027extern int null_strings, one_strings;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000028void
Fred Drake100814d2000-07-09 15:48:49 +000029dump_counts(void)
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000030{
Guido van Rossumc0b618a1997-05-02 03:12:38 +000031 PyTypeObject *tp;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000032
33 for (tp = type_list; tp; tp = tp->tp_next)
Sjoerd Mullender52c1f511993-10-25 08:40:52 +000034 fprintf(stderr, "%s alloc'd: %d, freed: %d, max in use: %d\n",
35 tp->tp_name, tp->tp_alloc, tp->tp_free,
36 tp->tp_maxalloc);
37 fprintf(stderr, "fast tuple allocs: %d, empty: %d\n",
38 fast_tuple_allocs, tuple_zero_allocs);
39 fprintf(stderr, "fast int allocs: pos: %d, neg: %d\n",
40 quick_int_allocs, quick_neg_int_allocs);
41 fprintf(stderr, "null strings: %d, 1-strings: %d\n",
42 null_strings, one_strings);
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000043}
44
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +000045PyObject *
Fred Drake100814d2000-07-09 15:48:49 +000046get_counts(void)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +000047{
48 PyTypeObject *tp;
49 PyObject *result;
50 PyObject *v;
51
52 result = PyList_New(0);
53 if (result == NULL)
54 return NULL;
55 for (tp = type_list; tp; tp = tp->tp_next) {
56 v = Py_BuildValue("(siii)", tp->tp_name, tp->tp_alloc,
57 tp->tp_free, tp->tp_maxalloc);
58 if (v == NULL) {
59 Py_DECREF(result);
60 return NULL;
61 }
62 if (PyList_Append(result, v) < 0) {
63 Py_DECREF(v);
64 Py_DECREF(result);
65 return NULL;
66 }
67 Py_DECREF(v);
68 }
69 return result;
70}
71
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000072void
Fred Drake100814d2000-07-09 15:48:49 +000073inc_count(PyTypeObject *tp)
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000074{
75 if (tp->tp_alloc == 0) {
Guido van Rossumd8953cb1995-04-06 14:46:26 +000076 /* first time; insert in linked list */
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000077 if (tp->tp_next != NULL) /* sanity check */
Guido van Rossumc0b618a1997-05-02 03:12:38 +000078 Py_FatalError("XXX inc_count sanity check");
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000079 tp->tp_next = type_list;
80 type_list = tp;
81 }
82 tp->tp_alloc++;
83 if (tp->tp_alloc - tp->tp_free > tp->tp_maxalloc)
84 tp->tp_maxalloc = tp->tp_alloc - tp->tp_free;
85}
86#endif
87
Guido van Rossumc0b618a1997-05-02 03:12:38 +000088PyObject *
Fred Drake100814d2000-07-09 15:48:49 +000089PyObject_Init(PyObject *op, PyTypeObject *tp)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000090{
Guido van Rossumb18618d2000-05-03 23:44:39 +000091 if (op == NULL) {
92 PyErr_SetString(PyExc_SystemError,
93 "NULL object passed to PyObject_Init");
94 return op;
95 }
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +000096#ifdef WITH_CYCLE_GC
97 if (PyType_IS_GC(tp))
98 op = (PyObject *) PyObject_FROM_GC(op);
99#endif
Guido van Rossumb18618d2000-05-03 23:44:39 +0000100 /* Any changes should be reflected in PyObject_INIT (objimpl.h) */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000101 op->ob_type = tp;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000102 _Py_NewReference(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000103 return op;
104}
105
Guido van Rossumb18618d2000-05-03 23:44:39 +0000106PyVarObject *
Fred Drake100814d2000-07-09 15:48:49 +0000107PyObject_InitVar(PyVarObject *op, PyTypeObject *tp, int size)
Guido van Rossumb18618d2000-05-03 23:44:39 +0000108{
109 if (op == NULL) {
110 PyErr_SetString(PyExc_SystemError,
111 "NULL object passed to PyObject_InitVar");
112 return op;
113 }
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000114#ifdef WITH_CYCLE_GC
115 if (PyType_IS_GC(tp))
116 op = (PyVarObject *) PyObject_FROM_GC(op);
117#endif
Guido van Rossumb18618d2000-05-03 23:44:39 +0000118 /* Any changes should be reflected in PyObject_INIT_VAR */
119 op->ob_size = size;
120 op->ob_type = tp;
121 _Py_NewReference((PyObject *)op);
122 return op;
123}
124
125PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000126_PyObject_New(PyTypeObject *tp)
Guido van Rossumb18618d2000-05-03 23:44:39 +0000127{
128 PyObject *op;
129 op = (PyObject *) PyObject_MALLOC(_PyObject_SIZE(tp));
130 if (op == NULL)
131 return PyErr_NoMemory();
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000132#ifdef WITH_CYCLE_GC
133 if (PyType_IS_GC(tp))
134 op = (PyObject *) PyObject_FROM_GC(op);
135#endif
Guido van Rossumb18618d2000-05-03 23:44:39 +0000136 return PyObject_INIT(op, tp);
137}
138
Guido van Rossumd0c87ee1997-05-15 21:31:03 +0000139PyVarObject *
Fred Drake100814d2000-07-09 15:48:49 +0000140_PyObject_NewVar(PyTypeObject *tp, int size)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000141{
Guido van Rossumb18618d2000-05-03 23:44:39 +0000142 PyVarObject *op;
143 op = (PyVarObject *) PyObject_MALLOC(_PyObject_VAR_SIZE(tp, size));
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000144 if (op == NULL)
Guido van Rossumd0c87ee1997-05-15 21:31:03 +0000145 return (PyVarObject *)PyErr_NoMemory();
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000146#ifdef WITH_CYCLE_GC
147 if (PyType_IS_GC(tp))
148 op = (PyVarObject *) PyObject_FROM_GC(op);
149#endif
Guido van Rossumb18618d2000-05-03 23:44:39 +0000150 return PyObject_INIT_VAR(op, tp, size);
151}
152
153void
Fred Drake100814d2000-07-09 15:48:49 +0000154_PyObject_Del(PyObject *op)
Guido van Rossumb18618d2000-05-03 23:44:39 +0000155{
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000156#ifdef WITH_CYCLE_GC
Guido van Rossum4cc6ac72000-07-01 01:00:38 +0000157 if (op && PyType_IS_GC(op->ob_type)) {
158 op = (PyObject *) PyObject_AS_GC(op);
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000159 }
Guido van Rossum4cc6ac72000-07-01 01:00:38 +0000160#endif
161 PyObject_FREE(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000162}
163
Jeremy Hyltonc5007aa2000-06-30 05:02:53 +0000164#ifndef WITH_CYCLE_GC
165/* extension modules might need these */
166void _PyGC_Insert(PyObject *op) { }
167void _PyGC_Remove(PyObject *op) { }
168#endif
169
Guido van Rossum90933611991-06-07 16:10:43 +0000170int
Fred Drake100814d2000-07-09 15:48:49 +0000171PyObject_Print(PyObject *op, FILE *fp, int flags)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000172{
Guido van Rossum278ef591991-07-27 21:40:24 +0000173 int ret = 0;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000174 if (PyErr_CheckSignals())
Guido van Rossum90933611991-06-07 16:10:43 +0000175 return -1;
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000176#ifdef USE_STACKCHECK
177 if (PyOS_CheckStack()) {
Fred Drake661ea262000-10-24 19:57:45 +0000178 PyErr_SetString(PyExc_MemoryError, "stack overflow");
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000179 return -1;
180 }
181#endif
Guido van Rossum687ef6e2000-01-12 16:28:58 +0000182 clearerr(fp); /* Clear any previous error condition */
Guido van Rossum90933611991-06-07 16:10:43 +0000183 if (op == NULL) {
184 fprintf(fp, "<nil>");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000185 }
Guido van Rossum90933611991-06-07 16:10:43 +0000186 else {
187 if (op->ob_refcnt <= 0)
Fred Drakea44d3532000-06-30 15:01:00 +0000188 fprintf(fp, "<refcnt %u at %p>",
189 op->ob_refcnt, op);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000190 else if (op->ob_type->tp_print == NULL) {
191 if (op->ob_type->tp_repr == NULL) {
Fred Drakea44d3532000-06-30 15:01:00 +0000192 fprintf(fp, "<%s object at %p>",
193 op->ob_type->tp_name, op);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000194 }
195 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000196 PyObject *s;
197 if (flags & Py_PRINT_RAW)
198 s = PyObject_Str(op);
Guido van Rossumc6004111993-11-05 10:22:19 +0000199 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000200 s = PyObject_Repr(op);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000201 if (s == NULL)
202 ret = -1;
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000203 else {
Guido van Rossum565798d1998-04-21 22:25:01 +0000204 ret = PyObject_Print(s, fp,
205 Py_PRINT_RAW);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000206 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000207 Py_XDECREF(s);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000208 }
209 }
Guido van Rossum90933611991-06-07 16:10:43 +0000210 else
Guido van Rossum278ef591991-07-27 21:40:24 +0000211 ret = (*op->ob_type->tp_print)(op, fp, flags);
Guido van Rossum90933611991-06-07 16:10:43 +0000212 }
Guido van Rossum278ef591991-07-27 21:40:24 +0000213 if (ret == 0) {
214 if (ferror(fp)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000215 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum278ef591991-07-27 21:40:24 +0000216 clearerr(fp);
217 ret = -1;
218 }
219 }
220 return ret;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000221}
222
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000223PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000224PyObject_Repr(PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000225{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000226 if (PyErr_CheckSignals())
Guido van Rossum90933611991-06-07 16:10:43 +0000227 return NULL;
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000228#ifdef USE_STACKCHECK
229 if (PyOS_CheckStack()) {
Fred Drake661ea262000-10-24 19:57:45 +0000230 PyErr_SetString(PyExc_MemoryError, "stack overflow");
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000231 return NULL;
232 }
233#endif
Guido van Rossum90933611991-06-07 16:10:43 +0000234 if (v == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000235 return PyString_FromString("<NULL>");
Guido van Rossum90933611991-06-07 16:10:43 +0000236 else if (v->ob_type->tp_repr == NULL) {
237 char buf[120];
Fred Drakea44d3532000-06-30 15:01:00 +0000238 sprintf(buf, "<%.80s object at %p>",
239 v->ob_type->tp_name, v);
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000240 return PyString_FromString(buf);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000241 }
Guido van Rossum4c08d552000-03-10 22:55:18 +0000242 else {
243 PyObject *res;
244 res = (*v->ob_type->tp_repr)(v);
245 if (res == NULL)
246 return NULL;
Fredrik Lundhefecc7d2000-07-01 14:31:09 +0000247 if (PyUnicode_Check(res)) {
248 PyObject* str;
Fredrik Lundh2a1e0602000-07-08 17:43:32 +0000249 str = PyUnicode_AsUnicodeEscapeString(res);
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000250 Py_DECREF(res);
251 if (str)
Fredrik Lundhefecc7d2000-07-01 14:31:09 +0000252 res = str;
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000253 else
254 return NULL;
Fredrik Lundhefecc7d2000-07-01 14:31:09 +0000255 }
Guido van Rossum4c08d552000-03-10 22:55:18 +0000256 if (!PyString_Check(res)) {
257 PyErr_Format(PyExc_TypeError,
Guido van Rossum5db862d2000-04-10 12:46:51 +0000258 "__repr__ returned non-string (type %.200s)",
Guido van Rossum4c08d552000-03-10 22:55:18 +0000259 res->ob_type->tp_name);
260 Py_DECREF(res);
261 return NULL;
262 }
263 return res;
264 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000265}
266
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000267PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000268PyObject_Str(PyObject *v)
Guido van Rossumc6004111993-11-05 10:22:19 +0000269{
Guido van Rossum4c08d552000-03-10 22:55:18 +0000270 PyObject *res;
271
Guido van Rossumc6004111993-11-05 10:22:19 +0000272 if (v == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000273 return PyString_FromString("<NULL>");
274 else if (PyString_Check(v)) {
275 Py_INCREF(v);
Guido van Rossumc6004111993-11-05 10:22:19 +0000276 return v;
277 }
Guido van Rossum32b582b1995-01-17 16:35:13 +0000278 else if (v->ob_type->tp_str != NULL)
Guido van Rossum4c08d552000-03-10 22:55:18 +0000279 res = (*v->ob_type->tp_str)(v);
Guido van Rossumc6004111993-11-05 10:22:19 +0000280 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000281 PyObject *func;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000282 if (!PyInstance_Check(v) ||
283 (func = PyObject_GetAttrString(v, "__str__")) == NULL) {
284 PyErr_Clear();
285 return PyObject_Repr(v);
Guido van Rossumc6004111993-11-05 10:22:19 +0000286 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000287 res = PyEval_CallObject(func, (PyObject *)NULL);
288 Py_DECREF(func);
Guido van Rossumc6004111993-11-05 10:22:19 +0000289 }
Guido van Rossum4c08d552000-03-10 22:55:18 +0000290 if (res == NULL)
291 return NULL;
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000292 if (PyUnicode_Check(res)) {
293 PyObject* str;
294 str = PyUnicode_AsEncodedString(res, NULL, NULL);
295 Py_DECREF(res);
296 if (str)
297 res = str;
298 else
299 return NULL;
300 }
Guido van Rossum4c08d552000-03-10 22:55:18 +0000301 if (!PyString_Check(res)) {
302 PyErr_Format(PyExc_TypeError,
Guido van Rossum5db862d2000-04-10 12:46:51 +0000303 "__str__ returned non-string (type %.200s)",
Guido van Rossum4c08d552000-03-10 22:55:18 +0000304 res->ob_type->tp_name);
305 Py_DECREF(res);
306 return NULL;
307 }
308 return res;
Guido van Rossumc6004111993-11-05 10:22:19 +0000309}
310
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000311PyObject *
312PyObject_Unicode(PyObject *v)
313{
314 PyObject *res;
315
316 if (v == NULL)
317 res = PyString_FromString("<NULL>");
318 else if (PyUnicode_Check(v)) {
319 Py_INCREF(v);
320 return v;
321 }
322 else if (PyString_Check(v))
323 res = v;
324 else if (v->ob_type->tp_str != NULL)
325 res = (*v->ob_type->tp_str)(v);
326 else {
327 PyObject *func;
328 static PyObject *strstr;
329 if (strstr == NULL) {
330 strstr= PyString_InternFromString("__str__");
331 if (strstr == NULL)
332 return NULL;
333 }
334 if (!PyInstance_Check(v) ||
335 (func = PyObject_GetAttr(v, strstr)) == NULL) {
336 PyErr_Clear();
337 res = PyObject_Repr(v);
338 }
339 else {
340 res = PyEval_CallObject(func, (PyObject *)NULL);
341 Py_DECREF(func);
342 }
343 }
344 if (res == NULL)
345 return NULL;
346 if (!PyUnicode_Check(res)) {
347 PyObject* str;
348 str = PyUnicode_FromObject(res);
349 Py_DECREF(res);
350 if (str)
351 res = str;
352 else
353 return NULL;
354 }
355 return res;
356}
357
358
Guido van Rossume797ec12001-01-17 15:24:28 +0000359/* Map rich comparison operators to their swapped version, e.g. LT --> GT */
360static int swapped_op[] = {Py_GT, Py_GE, Py_EQ, Py_NE, Py_LT, Py_LE};
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000361
Guido van Rossume797ec12001-01-17 15:24:28 +0000362/* Try a genuine rich comparison, returning an object. Return:
363 NULL for exception;
364 NotImplemented if this particular rich comparison is not implemented or
365 undefined;
366 some object not equal to NotImplemented if it is implemented
367 (this latter object may not be a Boolean).
368*/
369static PyObject *
370try_rich_compare(PyObject *v, PyObject *w, int op)
371{
372 richcmpfunc f;
373 PyObject *res;
374
375 if ((f = v->ob_type->tp_richcompare) != NULL) {
376 res = (*f)(v, w, op);
377 if (res != Py_NotImplemented)
378 return res;
379 Py_DECREF(res);
380 }
381 if ((f = w->ob_type->tp_richcompare) != NULL) {
382 return (*f)(w, v, swapped_op[op]);
383 }
384 res = Py_NotImplemented;
385 Py_INCREF(res);
386 return res;
387}
388
389/* Try a genuine rich comparison, returning an int. Return:
390 -1 for exception (including the case where try_rich_compare() returns an
391 object that's not a Boolean);
392 0 if the outcome is false;
393 1 if the outcome is true;
394 2 if this particular rich comparison is not implemented or undefined.
395*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000396static int
Guido van Rossume797ec12001-01-17 15:24:28 +0000397try_rich_compare_bool(PyObject *v, PyObject *w, int op)
398{
399 PyObject *res;
400 int ok;
401
402 if (v->ob_type->tp_richcompare == NULL &&
403 w->ob_type->tp_richcompare == NULL)
404 return 2; /* Shortcut, avoid INCREF+DECREF */
405 res = try_rich_compare(v, w, op);
406 if (res == NULL)
407 return -1;
408 if (res == Py_NotImplemented) {
409 Py_DECREF(res);
410 return 2;
411 }
412 ok = PyObject_IsTrue(res);
413 Py_DECREF(res);
414 return ok;
415}
416
417/* Try rich comparisons to determine a 3-way comparison. Return:
418 -2 for an exception;
419 -1 if v < w;
420 0 if v == w;
421 1 if v > w;
422 2 if this particular rich comparison is not implemented or undefined.
423*/
424static int
425try_rich_to_3way_compare(PyObject *v, PyObject *w)
426{
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000427 static struct { int op; int outcome; } tries[3] = {
428 /* Try this operator, and if it is true, use this outcome: */
429 {Py_EQ, 0},
430 {Py_LT, -1},
431 {Py_GT, 1},
432 };
433 int i;
434
Guido van Rossume797ec12001-01-17 15:24:28 +0000435 if (v->ob_type->tp_richcompare == NULL &&
436 w->ob_type->tp_richcompare == NULL)
437 return 2; /* Shortcut */
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000438
439 for (i = 0; i < 3; i++) {
440 switch (try_rich_compare_bool(v, w, tries[i].op)) {
441 case -1:
442 return -1;
443 case 1:
444 return tries[i].outcome;
445 }
Guido van Rossume797ec12001-01-17 15:24:28 +0000446 }
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000447
448 return 2;
Guido van Rossume797ec12001-01-17 15:24:28 +0000449}
450
451/* Try a 3-way comparison, returning an int. Return:
452 -2 for an exception;
453 -1 if v < w;
454 0 if v == w;
455 1 if v > w;
456 2 if this particular 3-way comparison is not implemented or undefined.
457*/
458static int
459try_3way_compare(PyObject *v, PyObject *w)
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000460{
461 int c;
Guido van Rossume797ec12001-01-17 15:24:28 +0000462 cmpfunc f;
463
464 /* Comparisons involving instances are given to instance_compare,
465 which has the same return conventions as this function. */
466
467 if (PyInstance_Check(v))
468 return (*v->ob_type->tp_compare)(v, w);
469 if (PyInstance_Check(w))
470 return (*w->ob_type->tp_compare)(v, w);
471
472 /* If the types are equal, don't bother with coercions etc. */
473 if (v->ob_type == w->ob_type) {
474 if ((f = v->ob_type->tp_compare) == NULL)
475 return 2;
476 c = (*f)(v, w);
477 if (PyErr_Occurred())
478 return -2;
479 return c < 0 ? -1 : c > 0 ? 1 : 0;
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000480 }
Guido van Rossume797ec12001-01-17 15:24:28 +0000481
482 /* Try coercion; if it fails, give up */
483 c = PyNumber_CoerceEx(&v, &w);
484 if (c < 0)
485 return -2;
486 if (c > 0)
487 return 2;
488
489 /* Try v's comparison, if defined */
490 if ((f = v->ob_type->tp_compare) != NULL) {
491 c = (*f)(v, w);
492 Py_DECREF(v);
493 Py_DECREF(w);
494 if (PyErr_Occurred())
495 return -2;
496 return c < 0 ? -1 : c > 0 ? 1 : 0;
497 }
498
499 /* Try w's comparison, if defined */
500 if ((f = w->ob_type->tp_compare) != NULL) {
501 c = (*f)(w, v); /* swapped! */
502 Py_DECREF(v);
503 Py_DECREF(w);
504 if (PyErr_Occurred())
505 return -2;
506 return c < 0 ? 1 : c > 0 ? -1 : 0; /* negated! */
507 }
508
509 /* No comparison defined */
510 Py_DECREF(v);
511 Py_DECREF(w);
512 return 2;
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000513}
514
Guido van Rossume797ec12001-01-17 15:24:28 +0000515/* Final fallback 3-way comparison, returning an int. Return:
516 -2 if an error occurred;
517 -1 if v < w;
518 0 if v == w;
519 1 if v > w.
520*/
521static int
522default_3way_compare(PyObject *v, PyObject *w)
523{
524 int c;
525
526 if (v->ob_type == w->ob_type) {
527 /* same type: compare pointers */
528 void *vv = v;
529 void *ww = w;
530 return (vv < ww) ? -1 : (vv > ww) ? 1 : 0;
531 }
532
533 /* Special case for Unicode */
534 if (PyUnicode_Check(v) || PyUnicode_Check(w)) {
535 c = PyUnicode_Compare(v, w);
536 if (!PyErr_Occurred())
537 return c;
538 /* TypeErrors are ignored: if Unicode coercion fails due
539 to one of the arguments not having the right type, we
540 continue as defined by the coercion protocol (see
541 above). Luckily, decoding errors are reported as
542 ValueErrors and are not masked by this technique. */
543 if (!PyErr_ExceptionMatches(PyExc_TypeError))
544 return -2;
545 PyErr_Clear();
546 }
547
548 /* different type: compare type names */
549 c = strcmp(v->ob_type->tp_name, w->ob_type->tp_name);
550 return (c < 0) ? -1 : (c > 0) ? 1 : 0;
551}
552
553#define CHECK_TYPES(o) PyType_HasFeature((o)->ob_type, Py_TPFLAGS_CHECKTYPES)
554
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000555static int
Fred Drake100814d2000-07-09 15:48:49 +0000556do_cmp(PyObject *v, PyObject *w)
Guido van Rossum20566841995-01-12 11:26:10 +0000557{
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000558 int c;
559
Guido van Rossume797ec12001-01-17 15:24:28 +0000560 c = try_rich_to_3way_compare(v, w);
561 if (c < 2)
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000562 return c;
Guido van Rossume797ec12001-01-17 15:24:28 +0000563 c = try_3way_compare(v, w);
564 if (c < 2)
565 return c;
566 return default_3way_compare(v, w);
Guido van Rossum20566841995-01-12 11:26:10 +0000567}
568
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000569/* compare_nesting is incremented before calling compare (for
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000570 some types) and decremented on exit. If the count exceeds the
571 nesting limit, enable code to detect circular data structures.
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000572
573 This is a tunable parameter that should only affect the performance
574 of comparisons, nothing else. Setting it high makes comparing deeply
575 nested non-cyclical data structures faster, but makes comparing cyclical
576 data structures slower.
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000577*/
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000578#define NESTING_LIMIT 20
579
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000580static int compare_nesting = 0;
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000581
582static PyObject*
Fred Drake100814d2000-07-09 15:48:49 +0000583get_inprogress_dict(void)
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000584{
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000585 static PyObject *key;
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000586 PyObject *tstate_dict, *inprogress;
587
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000588 if (key == NULL) {
589 key = PyString_InternFromString("cmp_state");
590 if (key == NULL)
591 return NULL;
592 }
593
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000594 tstate_dict = PyThreadState_GetDict();
595 if (tstate_dict == NULL) {
596 PyErr_BadInternalCall();
597 return NULL;
598 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000599
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000600 inprogress = PyDict_GetItem(tstate_dict, key);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000601 if (inprogress == NULL) {
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000602 inprogress = PyDict_New();
603 if (inprogress == NULL)
604 return NULL;
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000605 if (PyDict_SetItem(tstate_dict, key, inprogress) == -1) {
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000606 Py_DECREF(inprogress);
607 return NULL;
608 }
Jeremy Hyltona251ea02000-06-09 16:20:39 +0000609 Py_DECREF(inprogress);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000610 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000611
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000612 return inprogress;
613}
614
615static PyObject *
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000616check_recursion(PyObject *v, PyObject *w, int op)
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000617{
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000618 PyObject *inprogress;
619 PyObject *token;
Barry Warsaw9d23a4e2000-08-18 05:01:19 +0000620 Py_uintptr_t iv = (Py_uintptr_t)v;
621 Py_uintptr_t iw = (Py_uintptr_t)w;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000622 PyObject *x, *y, *z;
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000623
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000624 inprogress = get_inprogress_dict();
625 if (inprogress == NULL)
626 return NULL;
627
628 token = PyTuple_New(3);
629 if (token == NULL)
630 return NULL;
631
632 if (iv <= iw) {
633 PyTuple_SET_ITEM(token, 0, x = PyLong_FromVoidPtr((void *)v));
634 PyTuple_SET_ITEM(token, 1, y = PyLong_FromVoidPtr((void *)w));
635 if (op >= 0)
636 op = swapped_op[op];
637 } else {
638 PyTuple_SET_ITEM(token, 0, x = PyLong_FromVoidPtr((void *)w));
639 PyTuple_SET_ITEM(token, 1, y = PyLong_FromVoidPtr((void *)v));
640 }
641 PyTuple_SET_ITEM(token, 2, z = PyInt_FromLong((long)op));
642 if (x == NULL || y == NULL || z == NULL) {
643 Py_DECREF(token);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000644 return NULL;
645 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000646
647 if (PyDict_GetItem(inprogress, token) != NULL) {
648 Py_DECREF(token);
649 return Py_None; /* Without INCREF! */
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000650 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000651
652 if (PyDict_SetItem(inprogress, token, token) < 0) {
653 Py_DECREF(token);
654 return NULL;
655 }
656
657 return token;
658}
659
660static void
661delete_token(PyObject *token)
662{
663 PyObject *inprogress;
664
665 if (token == NULL || token == Py_None)
666 return;
667 inprogress = get_inprogress_dict();
668 if (inprogress == NULL)
669 PyErr_Clear();
670 else
671 PyDict_DelItem(inprogress, token);
672 Py_DECREF(token);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000673}
674
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000675int
Fred Drake100814d2000-07-09 15:48:49 +0000676PyObject_Compare(PyObject *v, PyObject *w)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000677{
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000678 PyTypeObject *vtp;
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000679 int result;
680
Jack Jansend49cbe12000-08-22 21:52:51 +0000681#if defined(USE_STACKCHECK)
Guido van Rossum9c0a99e2000-08-30 15:53:50 +0000682 if (PyOS_CheckStack()) {
Jack Jansend49cbe12000-08-22 21:52:51 +0000683 PyErr_SetString(PyExc_MemoryError, "Stack overflow");
684 return -1;
685 }
686#endif
Guido van Rossumc8b6df91997-05-23 00:06:51 +0000687 if (v == NULL || w == NULL) {
688 PyErr_BadInternalCall();
689 return -1;
690 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000691 if (v == w)
692 return 0;
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000693 vtp = v->ob_type;
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000694 compare_nesting++;
695 if (compare_nesting > NESTING_LIMIT &&
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000696 (vtp->tp_as_mapping
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000697 || (vtp->tp_as_sequence
698 && !PyString_Check(v)
699 && !PyTuple_Check(v)))) {
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000700 /* try to detect circular data structures */
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000701 PyObject *token = check_recursion(v, w, -1);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000702
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000703 if (token == NULL) {
704 result = -1;
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000705 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000706 else if (token == Py_None) {
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000707 /* already comparing these objects. assume
708 they're equal until shown otherwise */
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000709 result = 0;
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000710 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000711 else {
712 result = do_cmp(v, w);
713 delete_token(token);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000714 }
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000715 }
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000716 else {
717 result = do_cmp(v, w);
718 }
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000719 compare_nesting--;
Guido van Rossume797ec12001-01-17 15:24:28 +0000720 return result < 0 ? -1 : result;
721}
722
723static PyObject *
724try_3way_to_rich_compare(PyObject *v, PyObject *w, int op)
725{
726 int c;
727 PyObject *result;
728
729 c = try_3way_compare(v, w);
730 if (c <= -2)
731 return NULL;
732 if (c >= 2)
733 c = default_3way_compare(v, w);
734 switch (op) {
735 case Py_LT: c = c < 0; break;
736 case Py_LE: c = c <= 0; break;
737 case Py_EQ: c = c == 0; break;
738 case Py_NE: c = c != 0; break;
739 case Py_GT: c = c > 0; break;
740 case Py_GE: c = c >= 0; break;
741 }
742 result = c ? Py_True : Py_False;
743 Py_INCREF(result);
Jeremy Hylton4a3dd2d2000-04-14 19:13:24 +0000744 return result;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000745}
746
Guido van Rossume797ec12001-01-17 15:24:28 +0000747PyObject *
748do_richcmp(PyObject *v, PyObject *w, int op)
749{
750 PyObject *res;
751
752 res = try_rich_compare(v, w, op);
753 if (res != Py_NotImplemented)
754 return res;
755 Py_DECREF(res);
756
757 return try_3way_to_rich_compare(v, w, op);
758}
759
760PyObject *
761PyObject_RichCompare(PyObject *v, PyObject *w, int op)
762{
763 PyObject *res;
764
765 assert(Py_LT <= op && op <= Py_GE);
766
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000767 compare_nesting++;
768 if (compare_nesting > NESTING_LIMIT &&
769 (v->ob_type->tp_as_mapping
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000770 || (v->ob_type->tp_as_sequence
771 && !PyString_Check(v)
772 && !PyTuple_Check(v)))) {
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000773 /* try to detect circular data structures */
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000774 PyObject *token = check_recursion(v, w, op);
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000775
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000776 if (token == NULL) {
777 res = NULL;
Guido van Rossume797ec12001-01-17 15:24:28 +0000778 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000779 else if (token == Py_None) {
780 /* already comparing these objects with this operator.
781 assume they're equal until shown otherwise */
782 if (op == Py_EQ)
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000783 res = Py_True;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000784 else if (op == Py_NE)
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000785 res = Py_False;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000786 else {
787 PyErr_SetString(PyExc_ValueError,
788 "can't order recursive values");
789 res = NULL;
790 }
791 Py_XINCREF(res);
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000792 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000793 else {
794 res = do_richcmp(v, w, op);
795 delete_token(token);
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000796 }
Guido van Rossume797ec12001-01-17 15:24:28 +0000797 }
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000798 else {
799 res = do_richcmp(v, w, op);
800 }
Guido van Rossum2ffbf6b2001-01-17 21:27:02 +0000801 compare_nesting--;
Guido van Rossume797ec12001-01-17 15:24:28 +0000802 return res;
803}
804
805int
806PyObject_RichCompareBool(PyObject *v, PyObject *w, int op)
807{
808 PyObject *res = PyObject_RichCompare(v, w, op);
809 int ok;
810
811 if (res == NULL)
812 return -1;
813 ok = PyObject_IsTrue(res);
814 Py_DECREF(res);
815 return ok;
816}
Fred Drake13634cf2000-06-29 19:17:04 +0000817
818/* Set of hash utility functions to help maintaining the invariant that
819 iff a==b then hash(a)==hash(b)
820
821 All the utility functions (_Py_Hash*()) return "-1" to signify an error.
822*/
823
824long
Fred Drake100814d2000-07-09 15:48:49 +0000825_Py_HashDouble(double v)
Fred Drake13634cf2000-06-29 19:17:04 +0000826{
Tim Peters39dce292000-08-15 03:34:48 +0000827 double intpart, fractpart;
828 int expo;
829 long hipart;
830 long x; /* the final hash value */
831 /* This is designed so that Python numbers of different types
832 * that compare equal hash to the same value; otherwise comparisons
833 * of mapping keys will turn out weird.
834 */
835
836#ifdef MPW /* MPW C modf expects pointer to extended as second argument */
837{
838 extended e;
839 fractpart = modf(v, &e);
840 intpart = e;
841}
842#else
843 fractpart = modf(v, &intpart);
844#endif
845 if (fractpart == 0.0) {
846 /* This must return the same hash as an equal int or long. */
847 if (intpart > LONG_MAX || -intpart > LONG_MAX) {
848 /* Convert to long and use its hash. */
849 PyObject *plong; /* converted to Python long */
850 if (Py_IS_INFINITY(intpart))
851 /* can't convert to long int -- arbitrary */
852 v = v < 0 ? -271828.0 : 314159.0;
853 plong = PyLong_FromDouble(v);
854 if (plong == NULL)
855 return -1;
856 x = PyObject_Hash(plong);
857 Py_DECREF(plong);
858 return x;
859 }
860 /* Fits in a C long == a Python int, so is its own hash. */
861 x = (long)intpart;
862 if (x == -1)
863 x = -2;
864 return x;
865 }
866 /* The fractional part is non-zero, so we don't have to worry about
867 * making this match the hash of some other type.
868 * Use frexp to get at the bits in the double.
Fred Drake13634cf2000-06-29 19:17:04 +0000869 * Since the VAX D double format has 56 mantissa bits, which is the
870 * most of any double format in use, each of these parts may have as
871 * many as (but no more than) 56 significant bits.
Tim Peters39dce292000-08-15 03:34:48 +0000872 * So, assuming sizeof(long) >= 4, each part can be broken into two
873 * longs; frexp and multiplication are used to do that.
874 * Also, since the Cray double format has 15 exponent bits, which is
875 * the most of any double format in use, shifting the exponent field
876 * left by 15 won't overflow a long (again assuming sizeof(long) >= 4).
Fred Drake13634cf2000-06-29 19:17:04 +0000877 */
Tim Peters39dce292000-08-15 03:34:48 +0000878 v = frexp(v, &expo);
879 v *= 2147483648.0; /* 2**31 */
880 hipart = (long)v; /* take the top 32 bits */
881 v = (v - (double)hipart) * 2147483648.0; /* get the next 32 bits */
882 x = hipart + (long)v + (expo << 15);
883 if (x == -1)
884 x = -2;
885 return x;
Fred Drake13634cf2000-06-29 19:17:04 +0000886}
887
888long
Fred Drake100814d2000-07-09 15:48:49 +0000889_Py_HashPointer(void *p)
Fred Drake13634cf2000-06-29 19:17:04 +0000890{
891#if SIZEOF_LONG >= SIZEOF_VOID_P
892 return (long)p;
893#else
894 /* convert to a Python long and hash that */
895 PyObject* longobj;
896 long x;
897
898 if ((longobj = PyLong_FromVoidPtr(p)) == NULL) {
899 x = -1;
900 goto finally;
901 }
902 x = PyObject_Hash(longobj);
903
904finally:
905 Py_XDECREF(longobj);
906 return x;
907#endif
908}
909
910
Guido van Rossum9bfef441993-03-29 10:43:31 +0000911long
Fred Drake100814d2000-07-09 15:48:49 +0000912PyObject_Hash(PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000913{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000914 PyTypeObject *tp = v->ob_type;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000915 if (tp->tp_hash != NULL)
916 return (*tp->tp_hash)(v);
Fred Drake13634cf2000-06-29 19:17:04 +0000917 if (tp->tp_compare == NULL) {
918 return _Py_HashPointer(v); /* Use address as hash value */
919 }
Guido van Rossum9bfef441993-03-29 10:43:31 +0000920 /* If there's a cmp but no hash defined, the object can't be hashed */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000921 PyErr_SetString(PyExc_TypeError, "unhashable type");
Guido van Rossum9bfef441993-03-29 10:43:31 +0000922 return -1;
923}
924
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000925PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000926PyObject_GetAttrString(PyObject *v, char *name)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000927{
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000928 if (v->ob_type->tp_getattro != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000929 PyObject *w, *res;
Guido van Rossumc6d06701997-01-18 07:57:16 +0000930 w = PyString_InternFromString(name);
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000931 if (w == NULL)
932 return NULL;
933 res = (*v->ob_type->tp_getattro)(v, w);
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000934 Py_XDECREF(w);
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000935 return res;
936 }
937
Guido van Rossum3f5da241990-12-20 15:06:42 +0000938 if (v->ob_type->tp_getattr == NULL) {
Guido van Rossumdb935161998-01-19 22:16:36 +0000939 PyErr_Format(PyExc_AttributeError,
940 "'%.50s' object has no attribute '%.400s'",
941 v->ob_type->tp_name,
942 name);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000943 return NULL;
944 }
945 else {
946 return (*v->ob_type->tp_getattr)(v, name);
947 }
948}
949
950int
Fred Drake100814d2000-07-09 15:48:49 +0000951PyObject_HasAttrString(PyObject *v, char *name)
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000952{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000953 PyObject *res = PyObject_GetAttrString(v, name);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000954 if (res != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000955 Py_DECREF(res);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000956 return 1;
957 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000958 PyErr_Clear();
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000959 return 0;
960}
961
962int
Fred Drake100814d2000-07-09 15:48:49 +0000963PyObject_SetAttrString(PyObject *v, char *name, PyObject *w)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000964{
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000965 if (v->ob_type->tp_setattro != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000966 PyObject *s;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000967 int res;
Guido van Rossumc6d06701997-01-18 07:57:16 +0000968 s = PyString_InternFromString(name);
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000969 if (s == NULL)
Guido van Rossumb7fc3041996-09-11 22:51:25 +0000970 return -1;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000971 res = (*v->ob_type->tp_setattro)(v, s, w);
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000972 Py_XDECREF(s);
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000973 return res;
974 }
975
Guido van Rossum3f5da241990-12-20 15:06:42 +0000976 if (v->ob_type->tp_setattr == NULL) {
977 if (v->ob_type->tp_getattr == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000978 PyErr_SetString(PyExc_TypeError,
Guido van Rossum3ea74121991-12-24 13:28:03 +0000979 "attribute-less object (assign or del)");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000980 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000981 PyErr_SetString(PyExc_TypeError,
Guido van Rossum3ea74121991-12-24 13:28:03 +0000982 "object has read-only attributes");
Guido van Rossum73531a31990-12-20 23:12:40 +0000983 return -1;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000984 }
985 else {
986 return (*v->ob_type->tp_setattr)(v, name, w);
987 }
988}
989
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000990/* Internal API needed by PyObject_GetAttr(): */
991extern
992PyObject *_PyUnicode_AsDefaultEncodedString(PyObject *unicode,
993 const char *errors);
994
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000995PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000996PyObject_GetAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000997{
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000998 /* The Unicode to string conversion is done here because the
999 existing tp_getattro slots expect a string object as name
1000 and we wouldn't want to break those. */
1001 if (PyUnicode_Check(name)) {
1002 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
1003 if (name == NULL)
1004 return NULL;
1005 }
Jeremy Hylton99a8f902000-06-23 14:36:32 +00001006
1007 if (!PyString_Check(name)) {
1008 PyErr_SetString(PyExc_TypeError,
1009 "attribute name must be string");
1010 return NULL;
1011 }
Marc-André Lemburge44e5072000-09-18 16:20:57 +00001012 if (v->ob_type->tp_getattro != NULL)
1013 return (*v->ob_type->tp_getattro)(v, name);
1014 else
Jeremy Hylton99a8f902000-06-23 14:36:32 +00001015 return PyObject_GetAttrString(v, PyString_AS_STRING(name));
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001016}
1017
1018int
Fred Drake100814d2000-07-09 15:48:49 +00001019PyObject_HasAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001020{
1021 PyObject *res = PyObject_GetAttr(v, name);
1022 if (res != NULL) {
1023 Py_DECREF(res);
1024 return 1;
1025 }
1026 PyErr_Clear();
1027 return 0;
1028}
1029
1030int
Fred Drake100814d2000-07-09 15:48:49 +00001031PyObject_SetAttr(PyObject *v, PyObject *name, PyObject *value)
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001032{
1033 int err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +00001034
1035 /* The Unicode to string conversion is done here because the
1036 existing tp_setattro slots expect a string object as name
1037 and we wouldn't want to break those. */
1038 if (PyUnicode_Check(name)) {
1039 name = PyUnicode_AsEncodedString(name, NULL, NULL);
1040 if (name == NULL)
1041 return -1;
Jeremy Hylton99a8f902000-06-23 14:36:32 +00001042 }
Marc-André Lemburge44e5072000-09-18 16:20:57 +00001043 else
1044 Py_INCREF(name);
1045
1046 if (!PyString_Check(name)){
Jeremy Hylton99a8f902000-06-23 14:36:32 +00001047 PyErr_SetString(PyExc_TypeError,
1048 "attribute name must be string");
1049 err = -1;
1050 }
Marc-André Lemburge44e5072000-09-18 16:20:57 +00001051 else {
1052 PyString_InternInPlace(&name);
1053 if (v->ob_type->tp_setattro != NULL)
1054 err = (*v->ob_type->tp_setattro)(v, name, value);
1055 else
1056 err = PyObject_SetAttrString(v,
1057 PyString_AS_STRING(name), value);
1058 }
1059
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001060 Py_DECREF(name);
1061 return err;
1062}
1063
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001064/* Test a value used as condition, e.g., in a for or if statement.
1065 Return -1 if an error occurred */
1066
1067int
Fred Drake100814d2000-07-09 15:48:49 +00001068PyObject_IsTrue(PyObject *v)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001069{
1070 int res;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001071 if (v == Py_None)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001072 res = 0;
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001073 else if (v->ob_type->tp_as_number != NULL &&
1074 v->ob_type->tp_as_number->nb_nonzero != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001075 res = (*v->ob_type->tp_as_number->nb_nonzero)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001076 else if (v->ob_type->tp_as_mapping != NULL &&
1077 v->ob_type->tp_as_mapping->mp_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001078 res = (*v->ob_type->tp_as_mapping->mp_length)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001079 else if (v->ob_type->tp_as_sequence != NULL &&
1080 v->ob_type->tp_as_sequence->sq_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001081 res = (*v->ob_type->tp_as_sequence->sq_length)(v);
1082 else
1083 res = 1;
1084 if (res > 0)
1085 res = 1;
1086 return res;
1087}
1088
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001089/* equivalent of 'not v'
1090 Return -1 if an error occurred */
1091
1092int
Fred Drake100814d2000-07-09 15:48:49 +00001093PyObject_Not(PyObject *v)
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001094{
1095 int res;
1096 res = PyObject_IsTrue(v);
1097 if (res < 0)
1098 return res;
1099 return res == 0;
1100}
1101
Guido van Rossum5524a591995-01-10 15:26:20 +00001102/* Coerce two numeric types to the "larger" one.
1103 Increment the reference count on each argument.
Guido van Rossume797ec12001-01-17 15:24:28 +00001104 Return value:
1105 -1 if an error occurred;
1106 0 if the coercion succeeded (and then the reference counts are increased);
1107 1 if no coercion is possible (and no error is raised).
Guido van Rossum5524a591995-01-10 15:26:20 +00001108*/
Guido van Rossum5524a591995-01-10 15:26:20 +00001109int
Fred Drake100814d2000-07-09 15:48:49 +00001110PyNumber_CoerceEx(PyObject **pv, PyObject **pw)
Guido van Rossum5524a591995-01-10 15:26:20 +00001111{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001112 register PyObject *v = *pv;
1113 register PyObject *w = *pw;
Guido van Rossum5524a591995-01-10 15:26:20 +00001114 int res;
1115
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001116 if (v->ob_type == w->ob_type && !PyInstance_Check(v)) {
1117 Py_INCREF(v);
1118 Py_INCREF(w);
Guido van Rossum5524a591995-01-10 15:26:20 +00001119 return 0;
1120 }
1121 if (v->ob_type->tp_as_number && v->ob_type->tp_as_number->nb_coerce) {
1122 res = (*v->ob_type->tp_as_number->nb_coerce)(pv, pw);
1123 if (res <= 0)
1124 return res;
1125 }
1126 if (w->ob_type->tp_as_number && w->ob_type->tp_as_number->nb_coerce) {
1127 res = (*w->ob_type->tp_as_number->nb_coerce)(pw, pv);
1128 if (res <= 0)
1129 return res;
1130 }
Guido van Rossum242c6421997-11-19 16:03:17 +00001131 return 1;
1132}
1133
Guido van Rossume797ec12001-01-17 15:24:28 +00001134/* Coerce two numeric types to the "larger" one.
1135 Increment the reference count on each argument.
1136 Return -1 and raise an exception if no coercion is possible
1137 (and then no reference count is incremented).
1138*/
Guido van Rossum242c6421997-11-19 16:03:17 +00001139int
Fred Drake100814d2000-07-09 15:48:49 +00001140PyNumber_Coerce(PyObject **pv, PyObject **pw)
Guido van Rossum242c6421997-11-19 16:03:17 +00001141{
1142 int err = PyNumber_CoerceEx(pv, pw);
1143 if (err <= 0)
1144 return err;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001145 PyErr_SetString(PyExc_TypeError, "number coercion failed");
Guido van Rossum5524a591995-01-10 15:26:20 +00001146 return -1;
1147}
1148
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001149
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001150/* Test whether an object can be called */
1151
1152int
Fred Drake100814d2000-07-09 15:48:49 +00001153PyCallable_Check(PyObject *x)
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001154{
1155 if (x == NULL)
1156 return 0;
1157 if (x->ob_type->tp_call != NULL ||
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001158 PyFunction_Check(x) ||
1159 PyMethod_Check(x) ||
1160 PyCFunction_Check(x) ||
1161 PyClass_Check(x))
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001162 return 1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001163 if (PyInstance_Check(x)) {
1164 PyObject *call = PyObject_GetAttrString(x, "__call__");
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001165 if (call == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001166 PyErr_Clear();
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001167 return 0;
1168 }
1169 /* Could test recursively but don't, for fear of endless
1170 recursion if some joker sets self.__call__ = self */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001171 Py_DECREF(call);
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001172 return 1;
1173 }
1174 return 0;
1175}
1176
1177
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001178/*
1179NoObject is usable as a non-NULL undefined value, used by the macro None.
1180There is (and should be!) no way to create other objects of this type,
Guido van Rossum3f5da241990-12-20 15:06:42 +00001181so there is exactly one (which is indestructible, by the way).
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001182*/
1183
Guido van Rossum0c182a11992-03-27 17:26:13 +00001184/* ARGSUSED */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001185static PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001186none_repr(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001187{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001188 return PyString_FromString("None");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001189}
1190
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001191static PyTypeObject PyNothing_Type = {
1192 PyObject_HEAD_INIT(&PyType_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001193 0,
Guido van Rossum3f5da241990-12-20 15:06:42 +00001194 "None",
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001195 0,
1196 0,
1197 0, /*tp_dealloc*/ /*never called*/
Guido van Rossum7066dd71992-09-17 17:54:56 +00001198 0, /*tp_print*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001199 0, /*tp_getattr*/
1200 0, /*tp_setattr*/
1201 0, /*tp_compare*/
Guido van Rossum1d5735e1994-08-30 08:27:36 +00001202 (reprfunc)none_repr, /*tp_repr*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001203 0, /*tp_as_number*/
1204 0, /*tp_as_sequence*/
1205 0, /*tp_as_mapping*/
Guido van Rossum9bfef441993-03-29 10:43:31 +00001206 0, /*tp_hash */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001207};
1208
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001209PyObject _Py_NoneStruct = {
1210 PyObject_HEAD_INIT(&PyNothing_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001211};
1212
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001213/* NotImplemented is an object that can be used to signal that an
1214 operation is not implemented for the given type combination. */
1215
1216static PyObject *
1217NotImplemented_repr(PyObject *op)
1218{
1219 return PyString_FromString("NotImplemented");
1220}
1221
1222static PyTypeObject PyNotImplemented_Type = {
1223 PyObject_HEAD_INIT(&PyType_Type)
1224 0,
1225 "NotImplemented",
1226 0,
1227 0,
1228 0, /*tp_dealloc*/ /*never called*/
1229 0, /*tp_print*/
1230 0, /*tp_getattr*/
1231 0, /*tp_setattr*/
1232 0, /*tp_compare*/
1233 (reprfunc)NotImplemented_repr, /*tp_repr*/
1234 0, /*tp_as_number*/
1235 0, /*tp_as_sequence*/
1236 0, /*tp_as_mapping*/
1237 0, /*tp_hash */
1238};
1239
1240PyObject _Py_NotImplementedStruct = {
1241 PyObject_HEAD_INIT(&PyNotImplemented_Type)
1242};
1243
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001244
Guido van Rossum84a90321996-05-22 16:34:47 +00001245#ifdef Py_TRACE_REFS
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001246
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001247static PyObject refchain = {&refchain, &refchain};
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001248
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001249void
Fred Drake100814d2000-07-09 15:48:49 +00001250_Py_ResetReferences(void)
Guido van Rossume09fb551997-08-05 02:04:34 +00001251{
1252 refchain._ob_prev = refchain._ob_next = &refchain;
1253 _Py_RefTotal = 0;
1254}
1255
1256void
Fred Drake100814d2000-07-09 15:48:49 +00001257_Py_NewReference(PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001258{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001259 _Py_RefTotal++;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001260 op->ob_refcnt = 1;
1261 op->_ob_next = refchain._ob_next;
1262 op->_ob_prev = &refchain;
1263 refchain._ob_next->_ob_prev = op;
1264 refchain._ob_next = op;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +00001265#ifdef COUNT_ALLOCS
1266 inc_count(op->ob_type);
1267#endif
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001268}
1269
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001270void
Fred Drake100814d2000-07-09 15:48:49 +00001271_Py_ForgetReference(register PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001272{
Guido van Rossumbffd6832000-01-20 22:32:56 +00001273#ifdef SLOW_UNREF_CHECK
Guido van Rossum4c08d552000-03-10 22:55:18 +00001274 register PyObject *p;
Guido van Rossumbffd6832000-01-20 22:32:56 +00001275#endif
Guido van Rossumd7047b31995-01-02 19:07:15 +00001276 if (op->ob_refcnt < 0)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001277 Py_FatalError("UNREF negative refcnt");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001278 if (op == &refchain ||
Guido van Rossumd7047b31995-01-02 19:07:15 +00001279 op->_ob_prev->_ob_next != op || op->_ob_next->_ob_prev != op)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001280 Py_FatalError("UNREF invalid object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001281#ifdef SLOW_UNREF_CHECK
Guido van Rossum3f5da241990-12-20 15:06:42 +00001282 for (p = refchain._ob_next; p != &refchain; p = p->_ob_next) {
1283 if (p == op)
1284 break;
1285 }
Guido van Rossumd7047b31995-01-02 19:07:15 +00001286 if (p == &refchain) /* Not found */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001287 Py_FatalError("UNREF unknown object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001288#endif
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001289 op->_ob_next->_ob_prev = op->_ob_prev;
1290 op->_ob_prev->_ob_next = op->_ob_next;
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001291 op->_ob_next = op->_ob_prev = NULL;
Guido van Rossumd8953cb1995-04-06 14:46:26 +00001292#ifdef COUNT_ALLOCS
1293 op->ob_type->tp_free++;
1294#endif
Guido van Rossum3f5da241990-12-20 15:06:42 +00001295}
1296
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001297void
Fred Drake100814d2000-07-09 15:48:49 +00001298_Py_Dealloc(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001299{
Guido van Rossum9776adf1994-09-07 14:36:45 +00001300 destructor dealloc = op->ob_type->tp_dealloc;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001301 _Py_ForgetReference(op);
Guido van Rossum9776adf1994-09-07 14:36:45 +00001302 (*dealloc)(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001303}
1304
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001305void
Fred Drake100814d2000-07-09 15:48:49 +00001306_Py_PrintReferences(FILE *fp)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001307{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001308 PyObject *op;
Guido van Rossume09fb551997-08-05 02:04:34 +00001309 fprintf(fp, "Remaining objects:\n");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001310 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next) {
1311 fprintf(fp, "[%d] ", op->ob_refcnt);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001312 if (PyObject_Print(op, fp, 0) != 0)
1313 PyErr_Clear();
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001314 putc('\n', fp);
1315 }
1316}
1317
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001318PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001319_Py_GetObjects(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001320{
1321 int i, n;
1322 PyObject *t = NULL;
1323 PyObject *res, *op;
1324
1325 if (!PyArg_ParseTuple(args, "i|O", &n, &t))
1326 return NULL;
1327 op = refchain._ob_next;
1328 res = PyList_New(0);
1329 if (res == NULL)
1330 return NULL;
1331 for (i = 0; (n == 0 || i < n) && op != &refchain; i++) {
1332 while (op == self || op == args || op == res || op == t ||
1333 t != NULL && op->ob_type != (PyTypeObject *) t) {
1334 op = op->_ob_next;
1335 if (op == &refchain)
1336 return res;
1337 }
1338 if (PyList_Append(res, op) < 0) {
1339 Py_DECREF(res);
1340 return NULL;
1341 }
1342 op = op->_ob_next;
1343 }
1344 return res;
1345}
1346
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001347#endif
Guido van Rossum97ead3f1996-01-12 01:24:09 +00001348
1349
1350/* Hack to force loading of cobject.o */
Guido van Rossumda9c2711996-12-05 21:58:58 +00001351PyTypeObject *_Py_cobject_hack = &PyCObject_Type;
Guido van Rossum84a90321996-05-22 16:34:47 +00001352
1353
1354/* Hack to force loading of abstract.o */
Jeremy Hylton6253f832000-07-12 12:56:19 +00001355int (*_Py_abstract_hack)(PyObject *) = &PyObject_Size;
Guido van Rossume09fb551997-08-05 02:04:34 +00001356
1357
Andrew M. Kuchling1582a3a2000-08-16 12:27:23 +00001358/* Python's malloc wrappers (see pymem.h) */
Guido van Rossume09fb551997-08-05 02:04:34 +00001359
Thomas Wouters334fb892000-07-25 12:56:38 +00001360void *
Fred Drake100814d2000-07-09 15:48:49 +00001361PyMem_Malloc(size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001362{
1363#if _PyMem_EXTRA > 0
1364 if (nbytes == 0)
1365 nbytes = _PyMem_EXTRA;
1366#endif
Guido van Rossumb18618d2000-05-03 23:44:39 +00001367 return PyMem_MALLOC(nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001368}
1369
Thomas Wouters334fb892000-07-25 12:56:38 +00001370void *
1371PyMem_Realloc(void *p, size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001372{
1373#if _PyMem_EXTRA > 0
1374 if (nbytes == 0)
1375 nbytes = _PyMem_EXTRA;
1376#endif
Guido van Rossumb18618d2000-05-03 23:44:39 +00001377 return PyMem_REALLOC(p, nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001378}
1379
1380void
Thomas Wouters334fb892000-07-25 12:56:38 +00001381PyMem_Free(void *p)
Guido van Rossume09fb551997-08-05 02:04:34 +00001382{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001383 PyMem_FREE(p);
1384}
1385
1386
1387/* Python's object malloc wrappers (see objimpl.h) */
1388
Thomas Wouters334fb892000-07-25 12:56:38 +00001389void *
Fred Drake100814d2000-07-09 15:48:49 +00001390PyObject_Malloc(size_t nbytes)
Guido van Rossumb18618d2000-05-03 23:44:39 +00001391{
1392 return PyObject_MALLOC(nbytes);
1393}
1394
Thomas Wouters334fb892000-07-25 12:56:38 +00001395void *
1396PyObject_Realloc(void *p, size_t nbytes)
Guido van Rossumb18618d2000-05-03 23:44:39 +00001397{
1398 return PyObject_REALLOC(p, nbytes);
1399}
1400
1401void
Thomas Wouters334fb892000-07-25 12:56:38 +00001402PyObject_Free(void *p)
Guido van Rossumb18618d2000-05-03 23:44:39 +00001403{
1404 PyObject_FREE(p);
Guido van Rossume09fb551997-08-05 02:04:34 +00001405}
Guido van Rossum86610361998-04-10 22:32:46 +00001406
1407
1408/* These methods are used to control infinite recursion in repr, str, print,
1409 etc. Container objects that may recursively contain themselves,
1410 e.g. builtin dictionaries and lists, should used Py_ReprEnter() and
1411 Py_ReprLeave() to avoid infinite recursion.
1412
1413 Py_ReprEnter() returns 0 the first time it is called for a particular
1414 object and 1 every time thereafter. It returns -1 if an exception
1415 occurred. Py_ReprLeave() has no return value.
1416
1417 See dictobject.c and listobject.c for examples of use.
1418*/
1419
1420#define KEY "Py_Repr"
1421
1422int
Fred Drake100814d2000-07-09 15:48:49 +00001423Py_ReprEnter(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001424{
1425 PyObject *dict;
1426 PyObject *list;
1427 int i;
1428
1429 dict = PyThreadState_GetDict();
1430 if (dict == NULL)
1431 return -1;
1432 list = PyDict_GetItemString(dict, KEY);
1433 if (list == NULL) {
1434 list = PyList_New(0);
1435 if (list == NULL)
1436 return -1;
1437 if (PyDict_SetItemString(dict, KEY, list) < 0)
1438 return -1;
1439 Py_DECREF(list);
1440 }
1441 i = PyList_GET_SIZE(list);
1442 while (--i >= 0) {
1443 if (PyList_GET_ITEM(list, i) == obj)
1444 return 1;
1445 }
1446 PyList_Append(list, obj);
1447 return 0;
1448}
1449
1450void
Fred Drake100814d2000-07-09 15:48:49 +00001451Py_ReprLeave(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001452{
1453 PyObject *dict;
1454 PyObject *list;
1455 int i;
1456
1457 dict = PyThreadState_GetDict();
Guido van Rossumeb909461998-04-11 15:17:34 +00001458 if (dict == NULL)
1459 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001460 list = PyDict_GetItemString(dict, KEY);
Guido van Rossumeb909461998-04-11 15:17:34 +00001461 if (list == NULL || !PyList_Check(list))
1462 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001463 i = PyList_GET_SIZE(list);
1464 /* Count backwards because we always expect obj to be list[-1] */
1465 while (--i >= 0) {
1466 if (PyList_GET_ITEM(list, i) == obj) {
1467 PyList_SetSlice(list, i, i + 1, NULL);
1468 break;
1469 }
1470 }
1471}
Guido van Rossumd724b232000-03-13 16:01:29 +00001472
1473/*
1474 trashcan
1475 CT 2k0130
1476 non-recursively destroy nested objects
1477
1478 CT 2k0223
1479 everything is now done in a macro.
1480
1481 CT 2k0305
1482 modified to use functions, after Tim Peter's suggestion.
1483
1484 CT 2k0309
1485 modified to restore a possible error.
Guido van Rossum13ff8eb2000-03-25 18:39:19 +00001486
1487 CT 2k0325
1488 added better safe than sorry check for threadstate
Guido van Rossume92e6102000-04-24 15:40:53 +00001489
1490 CT 2k0422
1491 complete rewrite. We now build a chain via ob_type
1492 and save the limited number of types in ob_refcnt.
1493 This is perfect since we don't need any memory.
1494 A patch for free-threading would need just a lock.
Guido van Rossumd724b232000-03-13 16:01:29 +00001495*/
1496
Guido van Rossume92e6102000-04-24 15:40:53 +00001497#define Py_TRASHCAN_TUPLE 1
1498#define Py_TRASHCAN_LIST 2
1499#define Py_TRASHCAN_DICT 3
1500#define Py_TRASHCAN_FRAME 4
1501#define Py_TRASHCAN_TRACEBACK 5
1502/* extend here if other objects want protection */
1503
Guido van Rossumd724b232000-03-13 16:01:29 +00001504int _PyTrash_delete_nesting = 0;
Guido van Rossume92e6102000-04-24 15:40:53 +00001505
Guido van Rossumd724b232000-03-13 16:01:29 +00001506PyObject * _PyTrash_delete_later = NULL;
1507
1508void
Fred Drake100814d2000-07-09 15:48:49 +00001509_PyTrash_deposit_object(PyObject *op)
Guido van Rossumd724b232000-03-13 16:01:29 +00001510{
Guido van Rossume92e6102000-04-24 15:40:53 +00001511 int typecode;
Guido van Rossum13ff8eb2000-03-25 18:39:19 +00001512
Guido van Rossume92e6102000-04-24 15:40:53 +00001513 if (PyTuple_Check(op))
1514 typecode = Py_TRASHCAN_TUPLE;
1515 else if (PyList_Check(op))
1516 typecode = Py_TRASHCAN_LIST;
1517 else if (PyDict_Check(op))
1518 typecode = Py_TRASHCAN_DICT;
1519 else if (PyFrame_Check(op))
1520 typecode = Py_TRASHCAN_FRAME;
1521 else if (PyTraceBack_Check(op))
1522 typecode = Py_TRASHCAN_TRACEBACK;
Moshe Zadkacf703f02000-08-04 15:36:13 +00001523 else /* We have a bug here -- those are the only types in GC */ {
1524 Py_FatalError("Type not supported in GC -- internal bug");
1525 return; /* pacify compiler -- execution never here */
1526 }
Guido van Rossume92e6102000-04-24 15:40:53 +00001527 op->ob_refcnt = typecode;
Guido van Rossumd724b232000-03-13 16:01:29 +00001528
Guido van Rossume92e6102000-04-24 15:40:53 +00001529 op->ob_type = (PyTypeObject*)_PyTrash_delete_later;
1530 _PyTrash_delete_later = op;
Guido van Rossumd724b232000-03-13 16:01:29 +00001531}
1532
1533void
Fred Drake100814d2000-07-09 15:48:49 +00001534_PyTrash_destroy_chain(void)
Guido van Rossumd724b232000-03-13 16:01:29 +00001535{
1536 while (_PyTrash_delete_later) {
1537 PyObject *shredder = _PyTrash_delete_later;
Guido van Rossume92e6102000-04-24 15:40:53 +00001538 _PyTrash_delete_later = (PyObject*) shredder->ob_type;
1539
1540 switch (shredder->ob_refcnt) {
1541 case Py_TRASHCAN_TUPLE:
1542 shredder->ob_type = &PyTuple_Type;
1543 break;
1544 case Py_TRASHCAN_LIST:
1545 shredder->ob_type = &PyList_Type;
1546 break;
1547 case Py_TRASHCAN_DICT:
1548 shredder->ob_type = &PyDict_Type;
1549 break;
1550 case Py_TRASHCAN_FRAME:
1551 shredder->ob_type = &PyFrame_Type;
1552 break;
1553 case Py_TRASHCAN_TRACEBACK:
1554 shredder->ob_type = &PyTraceBack_Type;
1555 break;
1556 }
1557 _Py_NewReference(shredder);
1558
Guido van Rossumd724b232000-03-13 16:01:29 +00001559 ++_PyTrash_delete_nesting;
1560 Py_DECREF(shredder);
1561 --_PyTrash_delete_nesting;
1562 }
1563}