blob: f6d125f03c3ac636089901b2e02447f459009914 [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 Rossum50e9fb92006-08-17 05:42:55 +00005#include "sliceobject.h" /* For PyEllipsis_Type */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00006
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00007#ifdef __cplusplus
8extern "C" {
9#endif
10
Tim Peters34592512002-07-11 06:23:50 +000011#ifdef Py_REF_DEBUG
Neal Norwitz84632ee2006-03-04 20:00:59 +000012Py_ssize_t _Py_RefTotal;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000013
14Py_ssize_t
15_Py_GetRefTotal(void)
16{
17 PyObject *o;
18 Py_ssize_t total = _Py_RefTotal;
19 /* ignore the references to the dummy object of the dicts and sets
20 because they are not reliable and not useful (now that the
21 hash table code is well-tested) */
22 o = _PyDict_Dummy();
23 if (o != NULL)
24 total -= o->ob_refcnt;
25 o = _PySet_Dummy();
26 if (o != NULL)
27 total -= o->ob_refcnt;
28 return total;
29}
30#endif /* Py_REF_DEBUG */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000031
Mark Hammonda2905272002-07-29 13:42:14 +000032int Py_DivisionWarningFlag;
Guido van Rossum393661d2001-08-31 17:40:15 +000033
Guido van Rossum3f5da241990-12-20 15:06:42 +000034/* Object allocation routines used by NEWOBJ and NEWVAROBJ macros.
35 These are used by the individual routines for object creation.
36 Do not call them otherwise, they do not initialize the object! */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000037
Tim Peters78be7992003-03-23 02:51:01 +000038#ifdef Py_TRACE_REFS
Tim Peters7571a0f2003-03-23 17:52:28 +000039/* Head of circular doubly-linked list of all objects. These are linked
40 * together via the _ob_prev and _ob_next members of a PyObject, which
41 * exist only in a Py_TRACE_REFS build.
42 */
Tim Peters78be7992003-03-23 02:51:01 +000043static PyObject refchain = {&refchain, &refchain};
Tim Peters36eb4df2003-03-23 03:33:13 +000044
Tim Peters7571a0f2003-03-23 17:52:28 +000045/* Insert op at the front of the list of all objects. If force is true,
46 * op is added even if _ob_prev and _ob_next are non-NULL already. If
47 * force is false amd _ob_prev or _ob_next are non-NULL, do nothing.
48 * force should be true if and only if op points to freshly allocated,
49 * uninitialized memory, or you've unlinked op from the list and are
Tim Peters51f8d382003-03-23 18:06:08 +000050 * relinking it into the front.
Tim Peters7571a0f2003-03-23 17:52:28 +000051 * Note that objects are normally added to the list via _Py_NewReference,
52 * which is called by PyObject_Init. Not all objects are initialized that
53 * way, though; exceptions include statically allocated type objects, and
54 * statically allocated singletons (like Py_True and Py_None).
55 */
Tim Peters36eb4df2003-03-23 03:33:13 +000056void
Tim Peters7571a0f2003-03-23 17:52:28 +000057_Py_AddToAllObjects(PyObject *op, int force)
Tim Peters36eb4df2003-03-23 03:33:13 +000058{
Tim Peters7571a0f2003-03-23 17:52:28 +000059#ifdef Py_DEBUG
60 if (!force) {
61 /* If it's initialized memory, op must be in or out of
62 * the list unambiguously.
63 */
64 assert((op->_ob_prev == NULL) == (op->_ob_next == NULL));
65 }
Tim Peters78be7992003-03-23 02:51:01 +000066#endif
Tim Peters7571a0f2003-03-23 17:52:28 +000067 if (force || op->_ob_prev == NULL) {
68 op->_ob_next = refchain._ob_next;
69 op->_ob_prev = &refchain;
70 refchain._ob_next->_ob_prev = op;
71 refchain._ob_next = op;
72 }
73}
74#endif /* Py_TRACE_REFS */
Tim Peters78be7992003-03-23 02:51:01 +000075
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000076#ifdef COUNT_ALLOCS
Guido van Rossumc0b618a1997-05-02 03:12:38 +000077static PyTypeObject *type_list;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000078/* All types are added to type_list, at least when
79 they get one object created. That makes them
80 immortal, which unfortunately contributes to
81 garbage itself. If unlist_types_without_objects
82 is set, they will be removed from the type_list
83 once the last object is deallocated. */
84int unlist_types_without_objects;
Sjoerd Mullender842d2cc1993-10-15 16:18:48 +000085extern int tuple_zero_allocs, fast_tuple_allocs;
86extern int quick_int_allocs, quick_neg_int_allocs;
Sjoerd Mullender3bb8a051993-10-22 12:04:32 +000087extern int null_strings, one_strings;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000088void
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000089dump_counts(FILE* f)
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000090{
Guido van Rossumc0b618a1997-05-02 03:12:38 +000091 PyTypeObject *tp;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +000092
93 for (tp = type_list; tp; tp = tp->tp_next)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000094 fprintf(f, "%s alloc'd: %d, freed: %d, max in use: %d\n",
Tim Peters6d6c1a32001-08-02 04:15:00 +000095 tp->tp_name, tp->tp_allocs, tp->tp_frees,
Sjoerd Mullender52c1f511993-10-25 08:40:52 +000096 tp->tp_maxalloc);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000097 fprintf(f, "fast tuple allocs: %d, empty: %d\n",
Sjoerd Mullender52c1f511993-10-25 08:40:52 +000098 fast_tuple_allocs, tuple_zero_allocs);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000099 fprintf(f, "fast int allocs: pos: %d, neg: %d\n",
Sjoerd Mullender52c1f511993-10-25 08:40:52 +0000100 quick_int_allocs, quick_neg_int_allocs);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000101 fprintf(f, "null strings: %d, 1-strings: %d\n",
Sjoerd Mullender52c1f511993-10-25 08:40:52 +0000102 null_strings, one_strings);
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000103}
104
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000105PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000106get_counts(void)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000107{
108 PyTypeObject *tp;
109 PyObject *result;
110 PyObject *v;
111
112 result = PyList_New(0);
113 if (result == NULL)
114 return NULL;
115 for (tp = type_list; tp; tp = tp->tp_next) {
Thomas Wouters4d70c3d2006-06-08 14:42:34 +0000116 v = Py_BuildValue("(snnn)", tp->tp_name, tp->tp_allocs,
Tim Peters6d6c1a32001-08-02 04:15:00 +0000117 tp->tp_frees, tp->tp_maxalloc);
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +0000118 if (v == NULL) {
119 Py_DECREF(result);
120 return NULL;
121 }
122 if (PyList_Append(result, v) < 0) {
123 Py_DECREF(v);
124 Py_DECREF(result);
125 return NULL;
126 }
127 Py_DECREF(v);
128 }
129 return result;
130}
131
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000132void
Fred Drake100814d2000-07-09 15:48:49 +0000133inc_count(PyTypeObject *tp)
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000134{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000135 if (tp->tp_next == NULL && tp->tp_prev == NULL) {
Guido van Rossumd8953cb1995-04-06 14:46:26 +0000136 /* first time; insert in linked list */
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000137 if (tp->tp_next != NULL) /* sanity check */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000138 Py_FatalError("XXX inc_count sanity check");
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000139 if (type_list)
140 type_list->tp_prev = tp;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000141 tp->tp_next = type_list;
Tim Petersc6a3ff62002-07-08 22:11:52 +0000142 /* Note that as of Python 2.2, heap-allocated type objects
143 * can go away, but this code requires that they stay alive
144 * until program exit. That's why we're careful with
145 * refcounts here. type_list gets a new reference to tp,
146 * while ownership of the reference type_list used to hold
147 * (if any) was transferred to tp->tp_next in the line above.
148 * tp is thus effectively immortal after this.
149 */
150 Py_INCREF(tp);
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000151 type_list = tp;
Tim Peters3e40c7f2003-03-23 03:04:32 +0000152#ifdef Py_TRACE_REFS
Tim Peters7571a0f2003-03-23 17:52:28 +0000153 /* Also insert in the doubly-linked list of all objects,
154 * if not already there.
155 */
156 _Py_AddToAllObjects((PyObject *)tp, 0);
Tim Peters78be7992003-03-23 02:51:01 +0000157#endif
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000158 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000159 tp->tp_allocs++;
160 if (tp->tp_allocs - tp->tp_frees > tp->tp_maxalloc)
161 tp->tp_maxalloc = tp->tp_allocs - tp->tp_frees;
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000162}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000163
164void dec_count(PyTypeObject *tp)
165{
166 tp->tp_frees++;
167 if (unlist_types_without_objects &&
168 tp->tp_allocs == tp->tp_frees) {
169 /* unlink the type from type_list */
170 if (tp->tp_prev)
171 tp->tp_prev->tp_next = tp->tp_next;
172 else
173 type_list = tp->tp_next;
174 if (tp->tp_next)
175 tp->tp_next->tp_prev = tp->tp_prev;
176 tp->tp_next = tp->tp_prev = NULL;
177 Py_DECREF(tp);
178 }
179}
180
Sjoerd Mullendera9c3c221993-10-11 12:54:31 +0000181#endif
182
Tim Peters7c321a82002-07-09 02:57:01 +0000183#ifdef Py_REF_DEBUG
184/* Log a fatal error; doesn't return. */
185void
186_Py_NegativeRefcount(const char *fname, int lineno, PyObject *op)
187{
188 char buf[300];
189
190 PyOS_snprintf(buf, sizeof(buf),
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000191 "%s:%i object at %p has negative ref count "
192 "%" PY_FORMAT_SIZE_T "d",
193 fname, lineno, op, op->ob_refcnt);
Tim Peters7c321a82002-07-09 02:57:01 +0000194 Py_FatalError(buf);
195}
196
197#endif /* Py_REF_DEBUG */
198
Thomas Heller1328b522004-04-22 17:23:49 +0000199void
200Py_IncRef(PyObject *o)
201{
202 Py_XINCREF(o);
203}
204
205void
206Py_DecRef(PyObject *o)
207{
208 Py_XDECREF(o);
209}
210
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000211PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000212PyObject_Init(PyObject *op, PyTypeObject *tp)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000213{
Guido van Rossum6e08c142002-10-11 20:37:24 +0000214 if (op == NULL)
215 return PyErr_NoMemory();
Guido van Rossumb18618d2000-05-03 23:44:39 +0000216 /* Any changes should be reflected in PyObject_INIT (objimpl.h) */
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000217 Py_Type(op) = tp;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000218 _Py_NewReference(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000219 return op;
220}
221
Guido van Rossumb18618d2000-05-03 23:44:39 +0000222PyVarObject *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000223PyObject_InitVar(PyVarObject *op, PyTypeObject *tp, Py_ssize_t size)
Guido van Rossumb18618d2000-05-03 23:44:39 +0000224{
Guido van Rossum6e08c142002-10-11 20:37:24 +0000225 if (op == NULL)
226 return (PyVarObject *) PyErr_NoMemory();
Guido van Rossumb18618d2000-05-03 23:44:39 +0000227 /* Any changes should be reflected in PyObject_INIT_VAR */
228 op->ob_size = size;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000229 Py_Type(op) = tp;
Guido van Rossumb18618d2000-05-03 23:44:39 +0000230 _Py_NewReference((PyObject *)op);
231 return op;
232}
233
234PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000235_PyObject_New(PyTypeObject *tp)
Guido van Rossumb18618d2000-05-03 23:44:39 +0000236{
237 PyObject *op;
238 op = (PyObject *) PyObject_MALLOC(_PyObject_SIZE(tp));
239 if (op == NULL)
240 return PyErr_NoMemory();
241 return PyObject_INIT(op, tp);
242}
243
Guido van Rossumd0c87ee1997-05-15 21:31:03 +0000244PyVarObject *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000245_PyObject_NewVar(PyTypeObject *tp, Py_ssize_t nitems)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000246{
Guido van Rossumb18618d2000-05-03 23:44:39 +0000247 PyVarObject *op;
Tim Petersf2a67da2001-10-07 03:54:51 +0000248 const size_t size = _PyObject_VAR_SIZE(tp, nitems);
Tim Peters6d483d32001-10-06 21:27:34 +0000249 op = (PyVarObject *) PyObject_MALLOC(size);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000250 if (op == NULL)
Guido van Rossumd0c87ee1997-05-15 21:31:03 +0000251 return (PyVarObject *)PyErr_NoMemory();
Tim Peters6d483d32001-10-06 21:27:34 +0000252 return PyObject_INIT_VAR(op, tp, nitems);
Guido van Rossumb18618d2000-05-03 23:44:39 +0000253}
254
Neal Norwitz1a997502003-01-13 20:13:12 +0000255/* Implementation of PyObject_Print with recursion checking */
256static int
257internal_print(PyObject *op, FILE *fp, int flags, int nesting)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000258{
Guido van Rossum278ef591991-07-27 21:40:24 +0000259 int ret = 0;
Neal Norwitz1a997502003-01-13 20:13:12 +0000260 if (nesting > 10) {
261 PyErr_SetString(PyExc_RuntimeError, "print recursion");
262 return -1;
263 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000264 if (PyErr_CheckSignals())
Guido van Rossum90933611991-06-07 16:10:43 +0000265 return -1;
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000266#ifdef USE_STACKCHECK
267 if (PyOS_CheckStack()) {
Fred Drake661ea262000-10-24 19:57:45 +0000268 PyErr_SetString(PyExc_MemoryError, "stack overflow");
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000269 return -1;
270 }
271#endif
Guido van Rossum687ef6e2000-01-12 16:28:58 +0000272 clearerr(fp); /* Clear any previous error condition */
Guido van Rossum90933611991-06-07 16:10:43 +0000273 if (op == NULL) {
Thomas Wouters1b7f8912007-09-19 03:06:30 +0000274 Py_BEGIN_ALLOW_THREADS
Guido van Rossum90933611991-06-07 16:10:43 +0000275 fprintf(fp, "<nil>");
Thomas Wouters1b7f8912007-09-19 03:06:30 +0000276 Py_END_ALLOW_THREADS
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000277 }
Guido van Rossum90933611991-06-07 16:10:43 +0000278 else {
279 if (op->ob_refcnt <= 0)
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000280 /* XXX(twouters) cast refcount to long until %zd is
281 universally available */
Thomas Wouters1b7f8912007-09-19 03:06:30 +0000282 Py_BEGIN_ALLOW_THREADS
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000283 fprintf(fp, "<refcnt %ld at %p>",
284 (long)op->ob_refcnt, op);
Thomas Wouters1b7f8912007-09-19 03:06:30 +0000285 Py_END_ALLOW_THREADS
Guido van Rossum04dbf3b2007-08-07 19:51:00 +0000286 else {
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000287 PyObject *s;
288 if (flags & Py_PRINT_RAW)
289 s = PyObject_Str(op);
290 else
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000291 s = PyObject_Repr(op);
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000292 if (s == NULL)
293 ret = -1;
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000294 else if (PyString_Check(s)) {
295 fwrite(PyString_AS_STRING(s), 1,
296 PyString_GET_SIZE(s), fp);
297 }
298 else if (PyUnicode_Check(s)) {
299 PyObject *t;
300 t = _PyUnicode_AsDefaultEncodedString(s, NULL);
301 if (t == NULL)
302 ret = 0;
303 else {
304 fwrite(PyString_AS_STRING(t), 1,
305 PyString_GET_SIZE(t), fp);
306 }
307 }
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000308 else {
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000309 PyErr_Format(PyExc_TypeError,
310 "str() or repr() returned '%.100s'",
311 s->ob_type->tp_name);
312 ret = -1;
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000313 }
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000314 Py_XDECREF(s);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000315 }
Guido van Rossum90933611991-06-07 16:10:43 +0000316 }
Guido van Rossum278ef591991-07-27 21:40:24 +0000317 if (ret == 0) {
318 if (ferror(fp)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000319 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum278ef591991-07-27 21:40:24 +0000320 clearerr(fp);
321 ret = -1;
322 }
323 }
324 return ret;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000325}
326
Neal Norwitz1a997502003-01-13 20:13:12 +0000327int
328PyObject_Print(PyObject *op, FILE *fp, int flags)
329{
330 return internal_print(op, fp, flags, 0);
331}
332
Guido van Rossum38938152006-08-21 23:36:26 +0000333/* For debugging convenience. Set a breakpoint here and call it from your DLL */
334void
Thomas Woutersb2137042007-02-01 18:02:27 +0000335_Py_BreakPoint(void)
Guido van Rossum38938152006-08-21 23:36:26 +0000336{
337}
338
Neal Norwitz1a997502003-01-13 20:13:12 +0000339
Barry Warsaw9bf16442001-01-23 16:24:35 +0000340/* For debugging convenience. See Misc/gdbinit for some useful gdb hooks */
Guido van Rossum38938152006-08-21 23:36:26 +0000341void
342_PyObject_Dump(PyObject* op)
Barry Warsaw9bf16442001-01-23 16:24:35 +0000343{
Barry Warsaweefb1072001-02-22 22:39:18 +0000344 if (op == NULL)
345 fprintf(stderr, "NULL\n");
346 else {
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000347 fprintf(stderr, "object : ");
Barry Warsaweefb1072001-02-22 22:39:18 +0000348 (void)PyObject_Print(op, stderr, 0);
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000349 /* XXX(twouters) cast refcount to long until %zd is
350 universally available */
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000351 fprintf(stderr, "\n"
352 "type : %s\n"
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000353 "refcount: %ld\n"
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000354 "address : %p\n",
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000355 Py_Type(op)==NULL ? "NULL" : Py_Type(op)->tp_name,
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000356 (long)op->ob_refcnt,
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000357 op);
Barry Warsaweefb1072001-02-22 22:39:18 +0000358 }
Barry Warsaw9bf16442001-01-23 16:24:35 +0000359}
Barry Warsaw903138f2001-01-23 16:33:18 +0000360
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000361PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000362PyObject_Repr(PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000363{
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000364 PyObject *res;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000365 if (PyErr_CheckSignals())
Guido van Rossum90933611991-06-07 16:10:43 +0000366 return NULL;
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000367#ifdef USE_STACKCHECK
368 if (PyOS_CheckStack()) {
Fred Drake661ea262000-10-24 19:57:45 +0000369 PyErr_SetString(PyExc_MemoryError, "stack overflow");
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000370 return NULL;
371 }
372#endif
Guido van Rossum90933611991-06-07 16:10:43 +0000373 if (v == NULL)
Walter Dörwald1ab83302007-05-18 17:15:44 +0000374 return PyUnicode_FromString("<NULL>");
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000375 else if (Py_Type(v)->tp_repr == NULL)
Walter Dörwald1ab83302007-05-18 17:15:44 +0000376 return PyUnicode_FromFormat("<%s object at %p>", v->ob_type->tp_name, v);
Guido van Rossum4c08d552000-03-10 22:55:18 +0000377 else {
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000378 res = (*v->ob_type->tp_repr)(v);
379 if (res != NULL && !PyUnicode_Check(res)) {
Guido van Rossum4c08d552000-03-10 22:55:18 +0000380 PyErr_Format(PyExc_TypeError,
Guido van Rossum5db862d2000-04-10 12:46:51 +0000381 "__repr__ returned non-string (type %.200s)",
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000382 res->ob_type->tp_name);
383 Py_DECREF(res);
Guido van Rossum4c08d552000-03-10 22:55:18 +0000384 return NULL;
385 }
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000386 return res;
Guido van Rossum4c08d552000-03-10 22:55:18 +0000387 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000388}
389
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000390PyObject *
Walter Dörwald1ab83302007-05-18 17:15:44 +0000391PyObject_ReprStr8(PyObject *v)
392{
393 PyObject *resu = PyObject_Repr(v);
394 if (resu) {
395 PyObject *resb = PyUnicode_AsEncodedString(resu, NULL, NULL);
396 Py_DECREF(resu);
397 if (resb) {
398 PyObject *ress = PyString_FromStringAndSize(
399 PyBytes_AS_STRING(resb),
400 PyBytes_GET_SIZE(resb)
401 );
402 Py_DECREF(resb);
403 return ress;
404 }
405 }
406 return NULL;
407}
408
409PyObject *
Neil Schemenauercf52c072005-08-12 17:34:58 +0000410_PyObject_Str(PyObject *v)
Guido van Rossumc6004111993-11-05 10:22:19 +0000411{
Guido van Rossum4c08d552000-03-10 22:55:18 +0000412 PyObject *res;
Guido van Rossumc6004111993-11-05 10:22:19 +0000413 if (v == NULL)
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000414 return PyUnicode_FromString("<NULL>");
Tim Peters5a49ade2001-09-11 01:41:59 +0000415 if (PyString_CheckExact(v)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000416 Py_INCREF(v);
Guido van Rossumc6004111993-11-05 10:22:19 +0000417 return v;
418 }
Neil Schemenauercf52c072005-08-12 17:34:58 +0000419 if (PyUnicode_CheckExact(v)) {
420 Py_INCREF(v);
421 return v;
422 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000423 if (Py_Type(v)->tp_str == NULL)
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000424 return PyObject_Repr(v);
425
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000426 res = (*Py_Type(v)->tp_str)(v);
Guido van Rossum4c08d552000-03-10 22:55:18 +0000427 if (res == NULL)
428 return NULL;
Guido van Rossum55b4a7b2007-07-11 09:28:11 +0000429 if (!(PyString_Check(res) || PyUnicode_Check(res))) {
Neil Schemenauercf52c072005-08-12 17:34:58 +0000430 PyErr_Format(PyExc_TypeError,
431 "__str__ returned non-string (type %.200s)",
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000432 Py_Type(res)->tp_name);
Neil Schemenauercf52c072005-08-12 17:34:58 +0000433 Py_DECREF(res);
434 return NULL;
435 }
436 return res;
437}
438
439PyObject *
440PyObject_Str(PyObject *v)
441{
442 PyObject *res = _PyObject_Str(v);
443 if (res == NULL)
444 return NULL;
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000445 if (PyUnicode_Check(res)) {
446 PyObject* str;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000447 str = _PyUnicode_AsDefaultEncodedString(res, NULL);
448 Py_XINCREF(str);
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000449 Py_DECREF(res);
450 if (str)
451 res = str;
452 else
453 return NULL;
454 }
Neil Schemenauercf52c072005-08-12 17:34:58 +0000455 assert(PyString_Check(res));
Guido van Rossum4c08d552000-03-10 22:55:18 +0000456 return res;
Guido van Rossumc6004111993-11-05 10:22:19 +0000457}
458
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000459PyObject *
460PyObject_Unicode(PyObject *v)
461{
462 PyObject *res;
Brett Cannonc3647ac2005-04-26 03:45:26 +0000463 PyObject *func;
Neal Norwitz75801462006-03-14 06:02:16 +0000464 PyObject *str;
Brett Cannonc3647ac2005-04-26 03:45:26 +0000465 static PyObject *unicodestr;
Tim Peters803526b2002-07-07 05:13:56 +0000466
Walter Dörwaldb03ccc02007-05-11 17:25:52 +0000467 if (v == NULL)
468 return PyUnicode_FromString("<NULL>");
469 else if (PyUnicode_CheckExact(v)) {
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000470 Py_INCREF(v);
471 return v;
472 }
Brett Cannonc3647ac2005-04-26 03:45:26 +0000473 /* XXX As soon as we have a tp_unicode slot, we should
474 check this before trying the __unicode__
475 method. */
476 if (unicodestr == NULL) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000477 unicodestr= PyUnicode_InternFromString("__unicode__");
Brett Cannonc3647ac2005-04-26 03:45:26 +0000478 if (unicodestr == NULL)
479 return NULL;
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000480 }
Brett Cannonc3647ac2005-04-26 03:45:26 +0000481 func = PyObject_GetAttr(v, unicodestr);
482 if (func != NULL) {
483 res = PyEval_CallObject(func, (PyObject *)NULL);
484 Py_DECREF(func);
485 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000486 else {
Brett Cannonc3647ac2005-04-26 03:45:26 +0000487 PyErr_Clear();
Guido van Rossum55b4a7b2007-07-11 09:28:11 +0000488 if (PyUnicode_Check(v) &&
489 v->ob_type->tp_str == PyUnicode_Type.tp_str) {
490 /* For a Unicode subtype that's didn't overwrite
491 __unicode__ or __str__,
Brett Cannonc3647ac2005-04-26 03:45:26 +0000492 return a true Unicode object with the same data. */
493 return PyUnicode_FromUnicode(PyUnicode_AS_UNICODE(v),
494 PyUnicode_GET_SIZE(v));
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000495 }
Brett Cannonc3647ac2005-04-26 03:45:26 +0000496 if (PyString_CheckExact(v)) {
497 Py_INCREF(v);
498 res = v;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000499 }
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000500 else {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000501 if (Py_Type(v)->tp_str != NULL)
502 res = (*Py_Type(v)->tp_str)(v);
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000503 else
504 res = PyObject_Repr(v);
505 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000506 }
507 if (res == NULL)
508 return NULL;
509 if (!PyUnicode_Check(res)) {
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000510 str = PyUnicode_FromEncodedObject(res, NULL, "strict");
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000511 Py_DECREF(res);
Neal Norwitz75801462006-03-14 06:02:16 +0000512 res = str;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000513 }
514 return res;
515}
516
517
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000518/* The new comparison philosophy is: we completely separate three-way
519 comparison from rich comparison. That is, PyObject_Compare() and
520 PyObject_Cmp() *just* use the tp_compare slot. And PyObject_RichCompare()
521 and PyObject_RichCompareBool() *just* use the tp_richcompare slot.
522
523 See (*) below for practical amendments.
524
525 IOW, only cmp() uses tp_compare; the comparison operators (==, !=, <=, <,
526 >=, >) only use tp_richcompare. Note that list.sort() only uses <.
527
528 (And yes, eventually we'll rip out cmp() and tp_compare.)
529
530 The calling conventions are different: tp_compare only gets called with two
531 objects of the appropriate type; tp_richcompare gets called with a first
532 argument of the appropriate type and a second object of an arbitrary type.
533 We never do any kind of coercion.
534
535 The return conventions are also different.
536
537 The tp_compare slot should return a C int, as follows:
538
539 -1 if a < b or if an exception occurred
540 0 if a == b
541 +1 if a > b
542
543 No other return values are allowed. PyObject_Compare() has the same
544 calling convention.
545
546 The tp_richcompare slot should return an object, as follows:
547
548 NULL if an exception occurred
549 NotImplemented if the requested comparison is not implemented
550 any other false value if the requested comparison is false
551 any other true value if the requested comparison is true
552
553 The PyObject_RichCompare[Bool]() wrappers raise TypeError when they get
554 NotImplemented.
555
556 (*) Practical amendments:
557
558 - If rich comparison returns NotImplemented, == and != are decided by
559 comparing the object pointer (i.e. falling back to the base object
560 implementation).
561
562 - If three-way comparison is not implemented, it falls back on rich
563 comparison (but not the other way around!).
564
Guido van Rossuma4073002002-05-31 20:03:54 +0000565*/
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000566
567/* Forward */
568static PyObject *do_richcompare(PyObject *v, PyObject *w, int op);
569
570/* Perform a three-way comparison, raising TypeError if three-way comparison
571 is not supported. */
Guido van Rossuma4073002002-05-31 20:03:54 +0000572static int
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000573do_compare(PyObject *v, PyObject *w)
Guido van Rossuma4073002002-05-31 20:03:54 +0000574{
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000575 cmpfunc f;
576 int ok;
577
578 if (v->ob_type == w->ob_type &&
579 (f = v->ob_type->tp_compare) != NULL) {
580 return (*f)(v, w);
Guido van Rossuma4073002002-05-31 20:03:54 +0000581 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000582
583 /* Now try three-way compare before giving up. This is intentionally
584 elaborate; if you have a it will raise TypeError if it detects two
585 objects that aren't ordered with respect to each other. */
586 ok = PyObject_RichCompareBool(v, w, Py_LT);
587 if (ok < 0)
588 return -1; /* Error */
589 if (ok)
590 return -1; /* Less than */
591 ok = PyObject_RichCompareBool(v, w, Py_GT);
592 if (ok < 0)
593 return -1; /* Error */
594 if (ok)
595 return 1; /* Greater than */
596 ok = PyObject_RichCompareBool(v, w, Py_EQ);
597 if (ok < 0)
598 return -1; /* Error */
599 if (ok)
600 return 0; /* Equal */
601
602 /* Give up */
603 PyErr_Format(PyExc_TypeError,
Neal Norwitz3bd844e2006-08-29 04:39:12 +0000604 "unorderable types: '%.100s' != '%.100s'",
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000605 v->ob_type->tp_name,
606 w->ob_type->tp_name);
607 return -1;
Guido van Rossuma4073002002-05-31 20:03:54 +0000608}
609
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000610/* Perform a three-way comparison. This wraps do_compare() with a check for
611 NULL arguments and a recursion check. */
612int
613PyObject_Compare(PyObject *v, PyObject *w)
614{
615 int res;
Guido van Rossuma4073002002-05-31 20:03:54 +0000616
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000617 if (v == NULL || w == NULL) {
618 if (!PyErr_Occurred())
619 PyErr_BadInternalCall();
620 return -1;
621 }
622 if (Py_EnterRecursiveCall(" in cmp"))
623 return -1;
624 res = do_compare(v, w);
625 Py_LeaveRecursiveCall();
626 return res < 0 ? -1 : res;
627}
Guido van Rossumd1f06b92001-01-24 22:14:43 +0000628
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000629/* Map rich comparison operators to their swapped version, e.g. LT <--> GT */
Brett Cannona5ca2e72004-09-25 01:37:24 +0000630int _Py_SwappedOp[] = {Py_GT, Py_GE, Py_EQ, Py_NE, Py_LT, Py_LE};
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000631
Guido van Rossum9a4e95c2006-12-19 21:35:46 +0000632static char *opstrings[] = {"<", "<=", "==", "!=", ">", ">="};
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000633
634/* Perform a rich comparison, raising TypeError when the requested comparison
635 operator is not supported. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000636static PyObject *
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000637do_richcompare(PyObject *v, PyObject *w, int op)
Guido van Rossume797ec12001-01-17 15:24:28 +0000638{
639 richcmpfunc f;
640 PyObject *res;
641
Guido van Rossum2ed6bf82001-09-27 20:30:07 +0000642 if (v->ob_type != w->ob_type &&
643 PyType_IsSubtype(w->ob_type, v->ob_type) &&
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000644 (f = w->ob_type->tp_richcompare) != NULL) {
Tim Petersf4aca752004-09-23 02:39:37 +0000645 res = (*f)(w, v, _Py_SwappedOp[op]);
Guido van Rossum2ed6bf82001-09-27 20:30:07 +0000646 if (res != Py_NotImplemented)
647 return res;
648 Py_DECREF(res);
649 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000650 if ((f = v->ob_type->tp_richcompare) != NULL) {
Guido van Rossume797ec12001-01-17 15:24:28 +0000651 res = (*f)(v, w, op);
652 if (res != Py_NotImplemented)
653 return res;
654 Py_DECREF(res);
655 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000656 if ((f = w->ob_type->tp_richcompare) != NULL) {
657 res = (*f)(w, v, _Py_SwappedOp[op]);
658 if (res != Py_NotImplemented)
659 return res;
660 Py_DECREF(res);
Guido van Rossume797ec12001-01-17 15:24:28 +0000661 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000662 /* If neither object implements it, provide a sensible default
663 for == and !=, but raise an exception for ordering. */
664 switch (op) {
665 case Py_EQ:
666 res = (v == w) ? Py_True : Py_False;
667 break;
668 case Py_NE:
669 res = (v != w) ? Py_True : Py_False;
670 break;
671 default:
Guido van Rossum9a4e95c2006-12-19 21:35:46 +0000672 /* XXX Special-case None so it doesn't show as NoneType() */
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000673 PyErr_Format(PyExc_TypeError,
674 "unorderable types: %.100s() %s %.100s()",
675 v->ob_type->tp_name,
676 opstrings[op],
677 w->ob_type->tp_name);
678 return NULL;
679 }
Guido van Rossume797ec12001-01-17 15:24:28 +0000680 Py_INCREF(res);
681 return res;
682}
683
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000684/* Perform a rich comparison with object result. This wraps do_richcompare()
685 with a check for NULL arguments and a recursion check. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000686
Guido van Rossume797ec12001-01-17 15:24:28 +0000687PyObject *
688PyObject_RichCompare(PyObject *v, PyObject *w, int op)
689{
690 PyObject *res;
691
692 assert(Py_LT <= op && op <= Py_GE);
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000693 if (v == NULL || w == NULL) {
694 if (!PyErr_Occurred())
695 PyErr_BadInternalCall();
696 return NULL;
697 }
Armin Rigo2b3eb402003-10-28 12:05:48 +0000698 if (Py_EnterRecursiveCall(" in cmp"))
699 return NULL;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000700 res = do_richcompare(v, w, op);
Armin Rigo2b3eb402003-10-28 12:05:48 +0000701 Py_LeaveRecursiveCall();
Guido van Rossume797ec12001-01-17 15:24:28 +0000702 return res;
703}
704
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000705/* Perform a rich comparison with integer result. This wraps
706 PyObject_RichCompare(), returning -1 for error, 0 for false, 1 for true. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000707int
708PyObject_RichCompareBool(PyObject *v, PyObject *w, int op)
709{
Raymond Hettinger93d44812004-03-21 17:01:44 +0000710 PyObject *res;
Guido van Rossume797ec12001-01-17 15:24:28 +0000711 int ok;
712
Raymond Hettinger93d44812004-03-21 17:01:44 +0000713 res = PyObject_RichCompare(v, w, op);
Guido van Rossume797ec12001-01-17 15:24:28 +0000714 if (res == NULL)
715 return -1;
Guido van Rossum81912d42002-08-24 05:33:28 +0000716 if (PyBool_Check(res))
717 ok = (res == Py_True);
718 else
719 ok = PyObject_IsTrue(res);
Guido van Rossume797ec12001-01-17 15:24:28 +0000720 Py_DECREF(res);
721 return ok;
722}
Fred Drake13634cf2000-06-29 19:17:04 +0000723
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000724/* Turn the result of a three-way comparison into the result expected by a
725 rich comparison. */
726PyObject *
727Py_CmpToRich(int op, int cmp)
728{
729 PyObject *res;
730 int ok;
731
732 if (PyErr_Occurred())
733 return NULL;
734 switch (op) {
735 case Py_LT:
736 ok = cmp < 0;
737 break;
738 case Py_LE:
739 ok = cmp <= 0;
740 break;
741 case Py_EQ:
742 ok = cmp == 0;
743 break;
744 case Py_NE:
745 ok = cmp != 0;
746 break;
747 case Py_GT:
748 ok = cmp > 0;
749 break;
750 case Py_GE:
751 ok = cmp >= 0;
752 break;
753 default:
754 PyErr_BadArgument();
755 return NULL;
756 }
757 res = ok ? Py_True : Py_False;
758 Py_INCREF(res);
759 return res;
760}
761
Fred Drake13634cf2000-06-29 19:17:04 +0000762/* Set of hash utility functions to help maintaining the invariant that
Raymond Hettinger8183fa42004-03-21 17:35:06 +0000763 if a==b then hash(a)==hash(b)
Fred Drake13634cf2000-06-29 19:17:04 +0000764
765 All the utility functions (_Py_Hash*()) return "-1" to signify an error.
766*/
767
768long
Fred Drake100814d2000-07-09 15:48:49 +0000769_Py_HashDouble(double v)
Fred Drake13634cf2000-06-29 19:17:04 +0000770{
Tim Peters39dce292000-08-15 03:34:48 +0000771 double intpart, fractpart;
772 int expo;
773 long hipart;
774 long x; /* the final hash value */
775 /* This is designed so that Python numbers of different types
776 * that compare equal hash to the same value; otherwise comparisons
777 * of mapping keys will turn out weird.
778 */
779
Tim Peters39dce292000-08-15 03:34:48 +0000780 fractpart = modf(v, &intpart);
Tim Peters39dce292000-08-15 03:34:48 +0000781 if (fractpart == 0.0) {
782 /* This must return the same hash as an equal int or long. */
783 if (intpart > LONG_MAX || -intpart > LONG_MAX) {
784 /* Convert to long and use its hash. */
785 PyObject *plong; /* converted to Python long */
786 if (Py_IS_INFINITY(intpart))
787 /* can't convert to long int -- arbitrary */
788 v = v < 0 ? -271828.0 : 314159.0;
789 plong = PyLong_FromDouble(v);
790 if (plong == NULL)
791 return -1;
792 x = PyObject_Hash(plong);
793 Py_DECREF(plong);
794 return x;
795 }
796 /* Fits in a C long == a Python int, so is its own hash. */
797 x = (long)intpart;
798 if (x == -1)
799 x = -2;
800 return x;
801 }
802 /* The fractional part is non-zero, so we don't have to worry about
803 * making this match the hash of some other type.
804 * Use frexp to get at the bits in the double.
Fred Drake13634cf2000-06-29 19:17:04 +0000805 * Since the VAX D double format has 56 mantissa bits, which is the
806 * most of any double format in use, each of these parts may have as
807 * many as (but no more than) 56 significant bits.
Tim Peters39dce292000-08-15 03:34:48 +0000808 * So, assuming sizeof(long) >= 4, each part can be broken into two
809 * longs; frexp and multiplication are used to do that.
810 * Also, since the Cray double format has 15 exponent bits, which is
811 * the most of any double format in use, shifting the exponent field
812 * left by 15 won't overflow a long (again assuming sizeof(long) >= 4).
Fred Drake13634cf2000-06-29 19:17:04 +0000813 */
Tim Peters39dce292000-08-15 03:34:48 +0000814 v = frexp(v, &expo);
815 v *= 2147483648.0; /* 2**31 */
816 hipart = (long)v; /* take the top 32 bits */
817 v = (v - (double)hipart) * 2147483648.0; /* get the next 32 bits */
818 x = hipart + (long)v + (expo << 15);
819 if (x == -1)
820 x = -2;
821 return x;
Fred Drake13634cf2000-06-29 19:17:04 +0000822}
823
824long
Fred Drake100814d2000-07-09 15:48:49 +0000825_Py_HashPointer(void *p)
Fred Drake13634cf2000-06-29 19:17:04 +0000826{
827#if SIZEOF_LONG >= SIZEOF_VOID_P
828 return (long)p;
829#else
830 /* convert to a Python long and hash that */
831 PyObject* longobj;
832 long x;
Tim Peters803526b2002-07-07 05:13:56 +0000833
Fred Drake13634cf2000-06-29 19:17:04 +0000834 if ((longobj = PyLong_FromVoidPtr(p)) == NULL) {
835 x = -1;
836 goto finally;
837 }
838 x = PyObject_Hash(longobj);
Tim Peters803526b2002-07-07 05:13:56 +0000839
Fred Drake13634cf2000-06-29 19:17:04 +0000840finally:
841 Py_XDECREF(longobj);
842 return x;
843#endif
844}
845
846
Guido van Rossum9bfef441993-03-29 10:43:31 +0000847long
Fred Drake100814d2000-07-09 15:48:49 +0000848PyObject_Hash(PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000849{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000850 PyTypeObject *tp = v->ob_type;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000851 if (tp->tp_hash != NULL)
852 return (*tp->tp_hash)(v);
Guido van Rossum50e9fb92006-08-17 05:42:55 +0000853 /* Otherwise, the object can't be hashed */
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000854 PyErr_Format(PyExc_TypeError, "unhashable type: '%.200s'",
855 v->ob_type->tp_name);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000856 return -1;
857}
858
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000859PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000860PyObject_GetAttrString(PyObject *v, const char *name)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000861{
Tim Peters6d6c1a32001-08-02 04:15:00 +0000862 PyObject *w, *res;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000863
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000864 if (Py_Type(v)->tp_getattr != NULL)
865 return (*Py_Type(v)->tp_getattr)(v, (char*)name);
Martin v. Löwis5b222132007-06-10 09:51:05 +0000866 w = PyUnicode_InternFromString(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000867 if (w == NULL)
868 return NULL;
869 res = PyObject_GetAttr(v, w);
870 Py_XDECREF(w);
871 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000872}
873
874int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000875PyObject_HasAttrString(PyObject *v, const char *name)
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000876{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000877 PyObject *res = PyObject_GetAttrString(v, name);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000878 if (res != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000879 Py_DECREF(res);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000880 return 1;
881 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000882 PyErr_Clear();
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000883 return 0;
884}
885
886int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000887PyObject_SetAttrString(PyObject *v, const char *name, PyObject *w)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000888{
Tim Peters6d6c1a32001-08-02 04:15:00 +0000889 PyObject *s;
890 int res;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000891
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000892 if (Py_Type(v)->tp_setattr != NULL)
893 return (*Py_Type(v)->tp_setattr)(v, (char*)name, w);
Martin v. Löwis5b222132007-06-10 09:51:05 +0000894 s = PyUnicode_InternFromString(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000895 if (s == NULL)
896 return -1;
897 res = PyObject_SetAttr(v, s, w);
898 Py_XDECREF(s);
899 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000900}
901
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000902PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000903PyObject_GetAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000904{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000905 PyTypeObject *tp = Py_Type(v);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000906
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000907 if (!PyUnicode_Check(name)) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000908 PyErr_Format(PyExc_TypeError,
909 "attribute name must be string, not '%.200s'",
910 name->ob_type->tp_name);
911 return NULL;
Jeremy Hylton99a8f902000-06-23 14:36:32 +0000912 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000913 if (tp->tp_getattro != NULL)
914 return (*tp->tp_getattro)(v, name);
915 if (tp->tp_getattr != NULL)
Martin v. Löwis5b222132007-06-10 09:51:05 +0000916 return (*tp->tp_getattr)(v, PyUnicode_AsString(name));
Tim Peters6d6c1a32001-08-02 04:15:00 +0000917 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000918 "'%.50s' object has no attribute '%U'",
919 tp->tp_name, name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000920 return NULL;
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000921}
922
923int
Fred Drake100814d2000-07-09 15:48:49 +0000924PyObject_HasAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000925{
926 PyObject *res = PyObject_GetAttr(v, name);
927 if (res != NULL) {
928 Py_DECREF(res);
929 return 1;
930 }
931 PyErr_Clear();
932 return 0;
933}
934
935int
Fred Drake100814d2000-07-09 15:48:49 +0000936PyObject_SetAttr(PyObject *v, PyObject *name, PyObject *value)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000937{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000938 PyTypeObject *tp = Py_Type(v);
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000939 int err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000940
Martin v. Löwis5b222132007-06-10 09:51:05 +0000941 if (!PyUnicode_Check(name)) {
942 PyErr_Format(PyExc_TypeError,
943 "attribute name must be string, not '%.200s'",
944 name->ob_type->tp_name);
945 return -1;
Jeremy Hylton99a8f902000-06-23 14:36:32 +0000946 }
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000947 Py_INCREF(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000948
Martin v. Löwis5b222132007-06-10 09:51:05 +0000949 PyUnicode_InternInPlace(&name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000950 if (tp->tp_setattro != NULL) {
951 err = (*tp->tp_setattro)(v, name, value);
952 Py_DECREF(name);
953 return err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000954 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000955 if (tp->tp_setattr != NULL) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000956 err = (*tp->tp_setattr)(v, PyUnicode_AsString(name), value);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000957 Py_DECREF(name);
958 return err;
959 }
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000960 Py_DECREF(name);
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000961 assert(name->ob_refcnt >= 1);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000962 if (tp->tp_getattr == NULL && tp->tp_getattro == NULL)
963 PyErr_Format(PyExc_TypeError,
964 "'%.100s' object has no attributes "
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000965 "(%s .%U)",
Tim Peters6d6c1a32001-08-02 04:15:00 +0000966 tp->tp_name,
967 value==NULL ? "del" : "assign to",
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000968 name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000969 else
970 PyErr_Format(PyExc_TypeError,
971 "'%.100s' object has only read-only attributes "
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000972 "(%s .%U)",
Tim Peters6d6c1a32001-08-02 04:15:00 +0000973 tp->tp_name,
974 value==NULL ? "del" : "assign to",
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000975 name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000976 return -1;
977}
978
979/* Helper to get a pointer to an object's __dict__ slot, if any */
980
981PyObject **
982_PyObject_GetDictPtr(PyObject *obj)
983{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000984 Py_ssize_t dictoffset;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000985 PyTypeObject *tp = Py_Type(obj);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000986
Tim Peters6d6c1a32001-08-02 04:15:00 +0000987 dictoffset = tp->tp_dictoffset;
988 if (dictoffset == 0)
989 return NULL;
990 if (dictoffset < 0) {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000991 Py_ssize_t tsize;
Guido van Rossum2eb0b872002-03-01 22:24:49 +0000992 size_t size;
993
994 tsize = ((PyVarObject *)obj)->ob_size;
995 if (tsize < 0)
996 tsize = -tsize;
997 size = _PyObject_VAR_SIZE(tp, tsize);
998
Tim Peters6d483d32001-10-06 21:27:34 +0000999 dictoffset += (long)size;
1000 assert(dictoffset > 0);
1001 assert(dictoffset % SIZEOF_VOID_P == 0);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001002 }
1003 return (PyObject **) ((char *)obj + dictoffset);
1004}
1005
Tim Peters6d6c1a32001-08-02 04:15:00 +00001006PyObject *
Raymond Hettinger1da1dbf2003-03-17 19:46:11 +00001007PyObject_SelfIter(PyObject *obj)
Raymond Hettinger01538262003-03-17 08:24:35 +00001008{
1009 Py_INCREF(obj);
1010 return obj;
1011}
1012
Michael W. Hudson1593f502004-09-14 17:09:47 +00001013/* Generic GetAttr functions - put these in your tp_[gs]etattro slot */
1014
Raymond Hettinger01538262003-03-17 08:24:35 +00001015PyObject *
Tim Peters6d6c1a32001-08-02 04:15:00 +00001016PyObject_GenericGetAttr(PyObject *obj, PyObject *name)
1017{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001018 PyTypeObject *tp = Py_Type(obj);
Guido van Rossum056fbf42002-08-19 19:22:50 +00001019 PyObject *descr = NULL;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001020 PyObject *res = NULL;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001021 descrgetfunc f;
Martin v. Löwis725507b2006-03-07 12:08:51 +00001022 Py_ssize_t dictoffset;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001023 PyObject **dictptr;
1024
Martin v. Löwis5b222132007-06-10 09:51:05 +00001025 if (!PyUnicode_Check(name)){
1026 PyErr_Format(PyExc_TypeError,
1027 "attribute name must be string, not '%.200s'",
1028 name->ob_type->tp_name);
1029 return NULL;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001030 }
1031 else
1032 Py_INCREF(name);
1033
Tim Peters6d6c1a32001-08-02 04:15:00 +00001034 if (tp->tp_dict == NULL) {
Guido van Rossum528b7eb2001-08-07 17:24:28 +00001035 if (PyType_Ready(tp) < 0)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001036 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001037 }
1038
Guido van Rossum056fbf42002-08-19 19:22:50 +00001039 /* Inline _PyType_Lookup */
1040 {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001041 Py_ssize_t i, n;
Guido van Rossum056fbf42002-08-19 19:22:50 +00001042 PyObject *mro, *base, *dict;
1043
1044 /* Look in tp_dict of types in MRO */
1045 mro = tp->tp_mro;
1046 assert(mro != NULL);
1047 assert(PyTuple_Check(mro));
1048 n = PyTuple_GET_SIZE(mro);
1049 for (i = 0; i < n; i++) {
1050 base = PyTuple_GET_ITEM(mro, i);
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001051 assert(PyType_Check(base));
1052 dict = ((PyTypeObject *)base)->tp_dict;
Guido van Rossum056fbf42002-08-19 19:22:50 +00001053 assert(dict && PyDict_Check(dict));
1054 descr = PyDict_GetItem(dict, name);
1055 if (descr != NULL)
1056 break;
1057 }
1058 }
1059
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001060 Py_XINCREF(descr);
1061
Tim Peters6d6c1a32001-08-02 04:15:00 +00001062 f = NULL;
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00001063 if (descr != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001064 f = descr->ob_type->tp_descr_get;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001065 if (f != NULL && PyDescr_IsData(descr)) {
1066 res = f(descr, obj, (PyObject *)obj->ob_type);
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001067 Py_DECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001068 goto done;
1069 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001070 }
1071
Guido van Rossumc66ff442002-08-19 16:50:48 +00001072 /* Inline _PyObject_GetDictPtr */
1073 dictoffset = tp->tp_dictoffset;
1074 if (dictoffset != 0) {
1075 PyObject *dict;
1076 if (dictoffset < 0) {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001077 Py_ssize_t tsize;
Guido van Rossumc66ff442002-08-19 16:50:48 +00001078 size_t size;
1079
1080 tsize = ((PyVarObject *)obj)->ob_size;
1081 if (tsize < 0)
1082 tsize = -tsize;
1083 size = _PyObject_VAR_SIZE(tp, tsize);
1084
1085 dictoffset += (long)size;
1086 assert(dictoffset > 0);
1087 assert(dictoffset % SIZEOF_VOID_P == 0);
1088 }
1089 dictptr = (PyObject **) ((char *)obj + dictoffset);
1090 dict = *dictptr;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001091 if (dict != NULL) {
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001092 res = PyDict_GetItem(dict, name);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001093 if (res != NULL) {
1094 Py_INCREF(res);
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001095 Py_XDECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001096 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001097 }
1098 }
1099 }
1100
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001101 if (f != NULL) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001102 res = f(descr, obj, (PyObject *)Py_Type(obj));
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001103 Py_DECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001104 goto done;
1105 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001106
1107 if (descr != NULL) {
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001108 res = descr;
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001109 /* descr was already increfed above */
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001110 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001111 }
1112
1113 PyErr_Format(PyExc_AttributeError,
1114 "'%.50s' object has no attribute '%.400s'",
Martin v. Löwis5b222132007-06-10 09:51:05 +00001115 tp->tp_name, PyUnicode_AsString(name));
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001116 done:
1117 Py_DECREF(name);
1118 return res;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001119}
1120
1121int
1122PyObject_GenericSetAttr(PyObject *obj, PyObject *name, PyObject *value)
1123{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001124 PyTypeObject *tp = Py_Type(obj);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001125 PyObject *descr;
1126 descrsetfunc f;
1127 PyObject **dictptr;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001128 int res = -1;
1129
Martin v. Löwis5b222132007-06-10 09:51:05 +00001130 if (!PyUnicode_Check(name)){
1131 PyErr_Format(PyExc_TypeError,
1132 "attribute name must be string, not '%.200s'",
1133 name->ob_type->tp_name);
1134 return -1;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001135 }
1136 else
1137 Py_INCREF(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001138
1139 if (tp->tp_dict == NULL) {
Guido van Rossum528b7eb2001-08-07 17:24:28 +00001140 if (PyType_Ready(tp) < 0)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001141 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001142 }
1143
1144 descr = _PyType_Lookup(tp, name);
1145 f = NULL;
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00001146 if (descr != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001147 f = descr->ob_type->tp_descr_set;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001148 if (f != NULL && PyDescr_IsData(descr)) {
1149 res = f(descr, obj, value);
1150 goto done;
1151 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001152 }
1153
1154 dictptr = _PyObject_GetDictPtr(obj);
1155 if (dictptr != NULL) {
1156 PyObject *dict = *dictptr;
1157 if (dict == NULL && value != NULL) {
1158 dict = PyDict_New();
1159 if (dict == NULL)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001160 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001161 *dictptr = dict;
1162 }
1163 if (dict != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001164 if (value == NULL)
1165 res = PyDict_DelItem(dict, name);
1166 else
1167 res = PyDict_SetItem(dict, name, value);
1168 if (res < 0 && PyErr_ExceptionMatches(PyExc_KeyError))
1169 PyErr_SetObject(PyExc_AttributeError, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001170 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001171 }
1172 }
1173
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001174 if (f != NULL) {
1175 res = f(descr, obj, value);
1176 goto done;
1177 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001178
1179 if (descr == NULL) {
1180 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +00001181 "'%.100s' object has no attribute '%U'",
1182 tp->tp_name, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001183 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001184 }
1185
1186 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +00001187 "'%.50s' object attribute '%U' is read-only",
1188 tp->tp_name, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001189 done:
1190 Py_DECREF(name);
1191 return res;
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001192}
1193
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001194/* Test a value used as condition, e.g., in a for or if statement.
1195 Return -1 if an error occurred */
1196
1197int
Fred Drake100814d2000-07-09 15:48:49 +00001198PyObject_IsTrue(PyObject *v)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001199{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001200 Py_ssize_t res;
Guido van Rossum6248f442002-08-24 06:31:34 +00001201 if (v == Py_True)
1202 return 1;
1203 if (v == Py_False)
1204 return 0;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001205 if (v == Py_None)
Neal Norwitz51290d32002-06-13 21:32:44 +00001206 return 0;
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001207 else if (v->ob_type->tp_as_number != NULL &&
Jack Diederich4dafcc42006-11-28 19:15:13 +00001208 v->ob_type->tp_as_number->nb_bool != NULL)
1209 res = (*v->ob_type->tp_as_number->nb_bool)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001210 else if (v->ob_type->tp_as_mapping != NULL &&
1211 v->ob_type->tp_as_mapping->mp_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001212 res = (*v->ob_type->tp_as_mapping->mp_length)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001213 else if (v->ob_type->tp_as_sequence != NULL &&
1214 v->ob_type->tp_as_sequence->sq_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001215 res = (*v->ob_type->tp_as_sequence->sq_length)(v);
1216 else
Neal Norwitz51290d32002-06-13 21:32:44 +00001217 return 1;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001218 /* if it is negative, it should be either -1 or -2 */
1219 return (res > 0) ? 1 : Py_SAFE_DOWNCAST(res, Py_ssize_t, int);
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001220}
1221
Tim Peters803526b2002-07-07 05:13:56 +00001222/* equivalent of 'not v'
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001223 Return -1 if an error occurred */
1224
1225int
Fred Drake100814d2000-07-09 15:48:49 +00001226PyObject_Not(PyObject *v)
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001227{
1228 int res;
1229 res = PyObject_IsTrue(v);
1230 if (res < 0)
1231 return res;
1232 return res == 0;
1233}
1234
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001235/* Test whether an object can be called */
1236
1237int
Fred Drake100814d2000-07-09 15:48:49 +00001238PyCallable_Check(PyObject *x)
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001239{
1240 if (x == NULL)
1241 return 0;
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001242 return x->ob_type->tp_call != NULL;
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001243}
1244
Georg Brandle32b4222007-03-10 22:13:27 +00001245/* ------------------------- PyObject_Dir() helpers ------------------------- */
1246
Tim Peters7eea37e2001-09-04 22:08:56 +00001247/* Helper for PyObject_Dir.
1248 Merge the __dict__ of aclass into dict, and recursively also all
1249 the __dict__s of aclass's base classes. The order of merging isn't
1250 defined, as it's expected that only the final set of dict keys is
1251 interesting.
1252 Return 0 on success, -1 on error.
1253*/
1254
1255static int
1256merge_class_dict(PyObject* dict, PyObject* aclass)
1257{
1258 PyObject *classdict;
1259 PyObject *bases;
1260
1261 assert(PyDict_Check(dict));
1262 assert(aclass);
1263
1264 /* Merge in the type's dict (if any). */
1265 classdict = PyObject_GetAttrString(aclass, "__dict__");
1266 if (classdict == NULL)
1267 PyErr_Clear();
1268 else {
1269 int status = PyDict_Update(dict, classdict);
1270 Py_DECREF(classdict);
1271 if (status < 0)
1272 return -1;
1273 }
1274
1275 /* Recursively merge in the base types' (if any) dicts. */
1276 bases = PyObject_GetAttrString(aclass, "__bases__");
Tim Petersbc7e8632001-09-16 20:33:22 +00001277 if (bases == NULL)
1278 PyErr_Clear();
1279 else {
Guido van Rossum44022412002-05-13 18:29:46 +00001280 /* We have no guarantee that bases is a real tuple */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001281 Py_ssize_t i, n;
Guido van Rossum44022412002-05-13 18:29:46 +00001282 n = PySequence_Size(bases); /* This better be right */
1283 if (n < 0)
1284 PyErr_Clear();
1285 else {
1286 for (i = 0; i < n; i++) {
Tim Peters18e70832003-02-05 19:35:19 +00001287 int status;
Guido van Rossum44022412002-05-13 18:29:46 +00001288 PyObject *base = PySequence_GetItem(bases, i);
1289 if (base == NULL) {
1290 Py_DECREF(bases);
1291 return -1;
1292 }
Tim Peters18e70832003-02-05 19:35:19 +00001293 status = merge_class_dict(dict, base);
1294 Py_DECREF(base);
1295 if (status < 0) {
Guido van Rossum44022412002-05-13 18:29:46 +00001296 Py_DECREF(bases);
1297 return -1;
1298 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001299 }
1300 }
1301 Py_DECREF(bases);
1302 }
1303 return 0;
1304}
1305
Georg Brandle32b4222007-03-10 22:13:27 +00001306/* Helper for PyObject_Dir without arguments: returns the local scope. */
1307static PyObject *
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001308_dir_locals(void)
Tim Peters305b5852001-09-17 02:38:46 +00001309{
Georg Brandled3b8382007-03-12 13:15:14 +00001310 PyObject *names;
Georg Brandle32b4222007-03-10 22:13:27 +00001311 PyObject *locals = PyEval_GetLocals();
Tim Peters305b5852001-09-17 02:38:46 +00001312
Georg Brandle32b4222007-03-10 22:13:27 +00001313 if (locals == NULL) {
1314 PyErr_SetString(PyExc_SystemError, "frame does not exist");
1315 return NULL;
Tim Peters305b5852001-09-17 02:38:46 +00001316 }
1317
Georg Brandled3b8382007-03-12 13:15:14 +00001318 names = PyMapping_Keys(locals);
1319 if (!names)
1320 return NULL;
1321 if (!PyList_Check(names)) {
1322 PyErr_Format(PyExc_TypeError,
1323 "dir(): expected keys() of locals to be a list, "
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001324 "not '%.200s'", Py_Type(names)->tp_name);
Georg Brandled3b8382007-03-12 13:15:14 +00001325 Py_DECREF(names);
1326 return NULL;
1327 }
Georg Brandle32b4222007-03-10 22:13:27 +00001328 /* the locals don't need to be DECREF'd */
Georg Brandled3b8382007-03-12 13:15:14 +00001329 return names;
Georg Brandle32b4222007-03-10 22:13:27 +00001330}
1331
1332/* Helper for PyObject_Dir of type objects: returns __dict__ and __bases__.
1333 We deliberately don't suck up its __class__, as methods belonging to the
1334 metaclass would probably be more confusing than helpful.
1335*/
1336static PyObject *
1337_specialized_dir_type(PyObject *obj)
1338{
1339 PyObject *result = NULL;
1340 PyObject *dict = PyDict_New();
1341
1342 if (dict != NULL && merge_class_dict(dict, obj) == 0)
1343 result = PyDict_Keys(dict);
1344
1345 Py_XDECREF(dict);
Tim Peters305b5852001-09-17 02:38:46 +00001346 return result;
1347}
1348
Georg Brandle32b4222007-03-10 22:13:27 +00001349/* Helper for PyObject_Dir of module objects: returns the module's __dict__. */
1350static PyObject *
1351_specialized_dir_module(PyObject *obj)
Tim Peters7eea37e2001-09-04 22:08:56 +00001352{
Georg Brandle32b4222007-03-10 22:13:27 +00001353 PyObject *result = NULL;
1354 PyObject *dict = PyObject_GetAttrString(obj, "__dict__");
Tim Peters7eea37e2001-09-04 22:08:56 +00001355
Georg Brandle32b4222007-03-10 22:13:27 +00001356 if (dict != NULL) {
1357 if (PyDict_Check(dict))
1358 result = PyDict_Keys(dict);
1359 else {
1360 PyErr_Format(PyExc_TypeError,
1361 "%.200s.__dict__ is not a dictionary",
1362 PyModule_GetName(obj));
Guido van Rossum8dbd3d82001-09-10 18:27:43 +00001363 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001364 }
1365
Georg Brandle32b4222007-03-10 22:13:27 +00001366 Py_XDECREF(dict);
1367 return result;
1368}
Tim Peters7eea37e2001-09-04 22:08:56 +00001369
Georg Brandle32b4222007-03-10 22:13:27 +00001370/* Helper for PyObject_Dir of generic objects: returns __dict__, __class__,
1371 and recursively up the __class__.__bases__ chain.
1372*/
1373static PyObject *
1374_generic_dir(PyObject *obj)
1375{
1376 PyObject *result = NULL;
1377 PyObject *dict = NULL;
1378 PyObject *itsclass = NULL;
1379
1380 /* Get __dict__ (which may or may not be a real dict...) */
1381 dict = PyObject_GetAttrString(obj, "__dict__");
1382 if (dict == NULL) {
1383 PyErr_Clear();
1384 dict = PyDict_New();
1385 }
1386 else if (!PyDict_Check(dict)) {
1387 Py_DECREF(dict);
1388 dict = PyDict_New();
1389 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001390 else {
Georg Brandle32b4222007-03-10 22:13:27 +00001391 /* Copy __dict__ to avoid mutating it. */
1392 PyObject *temp = PyDict_Copy(dict);
1393 Py_DECREF(dict);
1394 dict = temp;
Tim Peters7eea37e2001-09-04 22:08:56 +00001395 }
1396
Georg Brandle32b4222007-03-10 22:13:27 +00001397 if (dict == NULL)
Raymond Hettinger2a7dede2004-08-07 04:55:30 +00001398 goto error;
Tim Peters7eea37e2001-09-04 22:08:56 +00001399
Georg Brandle32b4222007-03-10 22:13:27 +00001400 /* Merge in attrs reachable from its class. */
1401 itsclass = PyObject_GetAttrString(obj, "__class__");
1402 if (itsclass == NULL)
1403 /* XXX(tomer): Perhaps fall back to obj->ob_type if no
1404 __class__ exists? */
1405 PyErr_Clear();
1406 else {
1407 if (merge_class_dict(dict, itsclass) != 0)
1408 goto error;
1409 }
1410
1411 result = PyDict_Keys(dict);
Tim Peters7eea37e2001-09-04 22:08:56 +00001412 /* fall through */
Georg Brandle32b4222007-03-10 22:13:27 +00001413error:
1414 Py_XDECREF(itsclass);
1415 Py_XDECREF(dict);
1416 return result;
1417}
1418
1419/* Helper for PyObject_Dir: object introspection.
1420 This calls one of the above specialized versions if no __dir__ method
1421 exists. */
1422static PyObject *
1423_dir_object(PyObject *obj)
1424{
1425 PyObject * result = NULL;
1426 PyObject * dirfunc = PyObject_GetAttrString((PyObject*)obj->ob_type,
1427 "__dir__");
1428
1429 assert(obj);
1430 if (dirfunc == NULL) {
1431 /* use default implementation */
1432 PyErr_Clear();
1433 if (PyModule_Check(obj))
1434 result = _specialized_dir_module(obj);
1435 else if (PyType_Check(obj))
1436 result = _specialized_dir_type(obj);
1437 else
1438 result = _generic_dir(obj);
1439 }
1440 else {
1441 /* use __dir__ */
1442 result = PyObject_CallFunctionObjArgs(dirfunc, obj, NULL);
1443 Py_DECREF(dirfunc);
1444 if (result == NULL)
1445 return NULL;
1446
1447 /* result must be a list */
1448 /* XXX(gbrandl): could also check if all items are strings */
1449 if (!PyList_Check(result)) {
1450 PyErr_Format(PyExc_TypeError,
1451 "__dir__() must return a list, not %.200s",
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001452 Py_Type(result)->tp_name);
Georg Brandle32b4222007-03-10 22:13:27 +00001453 Py_DECREF(result);
1454 result = NULL;
1455 }
1456 }
1457
1458 return result;
1459}
1460
1461/* Implementation of dir() -- if obj is NULL, returns the names in the current
1462 (local) scope. Otherwise, performs introspection of the object: returns a
1463 sorted list of attribute names (supposedly) accessible from the object
1464*/
1465PyObject *
1466PyObject_Dir(PyObject *obj)
1467{
1468 PyObject * result;
1469
1470 if (obj == NULL)
1471 /* no object -- introspect the locals */
1472 result = _dir_locals();
1473 else
1474 /* object -- introspect the object */
1475 result = _dir_object(obj);
1476
1477 assert(result == NULL || PyList_Check(result));
1478
1479 if (result != NULL && PyList_Sort(result) != 0) {
1480 /* sorting the list failed */
1481 Py_DECREF(result);
1482 result = NULL;
1483 }
1484
Tim Peters7eea37e2001-09-04 22:08:56 +00001485 return result;
1486}
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001487
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001488/*
1489NoObject is usable as a non-NULL undefined value, used by the macro None.
1490There is (and should be!) no way to create other objects of this type,
Guido van Rossum3f5da241990-12-20 15:06:42 +00001491so there is exactly one (which is indestructible, by the way).
Guido van Rossumba21a492001-08-16 08:17:26 +00001492(XXX This type and the type of NotImplemented below should be unified.)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001493*/
1494
Guido van Rossum0c182a11992-03-27 17:26:13 +00001495/* ARGSUSED */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001496static PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001497none_repr(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001498{
Walter Dörwald1ab83302007-05-18 17:15:44 +00001499 return PyUnicode_FromString("None");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001500}
1501
Barry Warsaw9bf16442001-01-23 16:24:35 +00001502/* ARGUSED */
1503static void
Tim Peters803526b2002-07-07 05:13:56 +00001504none_dealloc(PyObject* ignore)
Barry Warsaw9bf16442001-01-23 16:24:35 +00001505{
1506 /* This should never get called, but we also don't want to SEGV if
1507 * we accidently decref None out of existance.
1508 */
Martin v. Löwis3f19b102002-08-07 16:21:51 +00001509 Py_FatalError("deallocating None");
Barry Warsaw9bf16442001-01-23 16:24:35 +00001510}
1511
1512
Guido van Rossumba21a492001-08-16 08:17:26 +00001513static PyTypeObject PyNone_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001514 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumba21a492001-08-16 08:17:26 +00001515 "NoneType",
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001516 0,
1517 0,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001518 none_dealloc, /*tp_dealloc*/ /*never called*/
Guido van Rossum7066dd71992-09-17 17:54:56 +00001519 0, /*tp_print*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001520 0, /*tp_getattr*/
1521 0, /*tp_setattr*/
1522 0, /*tp_compare*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001523 none_repr, /*tp_repr*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001524 0, /*tp_as_number*/
1525 0, /*tp_as_sequence*/
1526 0, /*tp_as_mapping*/
Guido van Rossum9bfef441993-03-29 10:43:31 +00001527 0, /*tp_hash */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001528};
1529
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001530PyObject _Py_NoneStruct = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001531 _PyObject_EXTRA_INIT
1532 1, &PyNone_Type
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001533};
1534
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001535/* NotImplemented is an object that can be used to signal that an
1536 operation is not implemented for the given type combination. */
1537
1538static PyObject *
1539NotImplemented_repr(PyObject *op)
1540{
Walter Dörwald1ab83302007-05-18 17:15:44 +00001541 return PyUnicode_FromString("NotImplemented");
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001542}
1543
1544static PyTypeObject PyNotImplemented_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001545 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumba21a492001-08-16 08:17:26 +00001546 "NotImplementedType",
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001547 0,
1548 0,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001549 none_dealloc, /*tp_dealloc*/ /*never called*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001550 0, /*tp_print*/
1551 0, /*tp_getattr*/
1552 0, /*tp_setattr*/
1553 0, /*tp_compare*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001554 NotImplemented_repr, /*tp_repr*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001555 0, /*tp_as_number*/
1556 0, /*tp_as_sequence*/
1557 0, /*tp_as_mapping*/
1558 0, /*tp_hash */
1559};
1560
1561PyObject _Py_NotImplementedStruct = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001562 _PyObject_EXTRA_INIT
1563 1, &PyNotImplemented_Type
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001564};
1565
Guido van Rossumba21a492001-08-16 08:17:26 +00001566void
1567_Py_ReadyTypes(void)
1568{
1569 if (PyType_Ready(&PyType_Type) < 0)
1570 Py_FatalError("Can't initialize 'type'");
1571
Fred Drake0a4dd392004-07-02 18:57:45 +00001572 if (PyType_Ready(&_PyWeakref_RefType) < 0)
1573 Py_FatalError("Can't initialize 'weakref'");
1574
Guido van Rossum77f6a652002-04-03 22:41:51 +00001575 if (PyType_Ready(&PyBool_Type) < 0)
1576 Py_FatalError("Can't initialize 'bool'");
1577
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001578 if (PyType_Ready(&PyBytes_Type) < 0)
1579 Py_FatalError("Can't initialize 'bytes'");
1580
Guido van Rossumcacfc072002-05-24 19:01:59 +00001581 if (PyType_Ready(&PyString_Type) < 0)
1582 Py_FatalError("Can't initialize 'str'");
1583
Guido van Rossumba21a492001-08-16 08:17:26 +00001584 if (PyType_Ready(&PyList_Type) < 0)
1585 Py_FatalError("Can't initialize 'list'");
1586
1587 if (PyType_Ready(&PyNone_Type) < 0)
1588 Py_FatalError("Can't initialize type(None)");
1589
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001590 if (PyType_Ready(Py_Ellipsis->ob_type) < 0)
1591 Py_FatalError("Can't initialize type(Ellipsis)");
1592
Guido van Rossumba21a492001-08-16 08:17:26 +00001593 if (PyType_Ready(&PyNotImplemented_Type) < 0)
1594 Py_FatalError("Can't initialize type(NotImplemented)");
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001595
1596 if (PyType_Ready(&PyCode_Type) < 0)
1597 Py_FatalError("Can't initialize 'code'");
Guido van Rossumba21a492001-08-16 08:17:26 +00001598}
1599
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001600
Guido van Rossum84a90321996-05-22 16:34:47 +00001601#ifdef Py_TRACE_REFS
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001602
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001603void
Fred Drake100814d2000-07-09 15:48:49 +00001604_Py_NewReference(PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001605{
Tim Peters34592512002-07-11 06:23:50 +00001606 _Py_INC_REFTOTAL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001607 op->ob_refcnt = 1;
Tim Peters7571a0f2003-03-23 17:52:28 +00001608 _Py_AddToAllObjects(op, 1);
Tim Peters34592512002-07-11 06:23:50 +00001609 _Py_INC_TPALLOCS(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001610}
1611
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001612void
Fred Drake100814d2000-07-09 15:48:49 +00001613_Py_ForgetReference(register PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001614{
Guido van Rossumbffd6832000-01-20 22:32:56 +00001615#ifdef SLOW_UNREF_CHECK
Guido van Rossum4c08d552000-03-10 22:55:18 +00001616 register PyObject *p;
Guido van Rossumbffd6832000-01-20 22:32:56 +00001617#endif
Guido van Rossumd7047b31995-01-02 19:07:15 +00001618 if (op->ob_refcnt < 0)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001619 Py_FatalError("UNREF negative refcnt");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001620 if (op == &refchain ||
Guido van Rossumd7047b31995-01-02 19:07:15 +00001621 op->_ob_prev->_ob_next != op || op->_ob_next->_ob_prev != op)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001622 Py_FatalError("UNREF invalid object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001623#ifdef SLOW_UNREF_CHECK
Guido van Rossum3f5da241990-12-20 15:06:42 +00001624 for (p = refchain._ob_next; p != &refchain; p = p->_ob_next) {
1625 if (p == op)
1626 break;
1627 }
Guido van Rossumd7047b31995-01-02 19:07:15 +00001628 if (p == &refchain) /* Not found */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001629 Py_FatalError("UNREF unknown object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001630#endif
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001631 op->_ob_next->_ob_prev = op->_ob_prev;
1632 op->_ob_prev->_ob_next = op->_ob_next;
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001633 op->_ob_next = op->_ob_prev = NULL;
Tim Peters34592512002-07-11 06:23:50 +00001634 _Py_INC_TPFREES(op);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001635}
1636
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001637void
Fred Drake100814d2000-07-09 15:48:49 +00001638_Py_Dealloc(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001639{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001640 destructor dealloc = Py_Type(op)->tp_dealloc;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001641 _Py_ForgetReference(op);
Guido van Rossum9776adf1994-09-07 14:36:45 +00001642 (*dealloc)(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001643}
1644
Tim Peters269b2a62003-04-17 19:52:29 +00001645/* Print all live objects. Because PyObject_Print is called, the
1646 * interpreter must be in a healthy state.
1647 */
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001648void
Fred Drake100814d2000-07-09 15:48:49 +00001649_Py_PrintReferences(FILE *fp)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001650{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001651 PyObject *op;
Guido van Rossume09fb551997-08-05 02:04:34 +00001652 fprintf(fp, "Remaining objects:\n");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001653 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next) {
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001654 fprintf(fp, "%p [%" PY_FORMAT_SIZE_T "d] ", op, op->ob_refcnt);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001655 if (PyObject_Print(op, fp, 0) != 0)
1656 PyErr_Clear();
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001657 putc('\n', fp);
1658 }
1659}
1660
Tim Peters269b2a62003-04-17 19:52:29 +00001661/* Print the addresses of all live objects. Unlike _Py_PrintReferences, this
1662 * doesn't make any calls to the Python C API, so is always safe to call.
1663 */
1664void
1665_Py_PrintReferenceAddresses(FILE *fp)
1666{
1667 PyObject *op;
1668 fprintf(fp, "Remaining object addresses:\n");
1669 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001670 fprintf(fp, "%p [%" PY_FORMAT_SIZE_T "d] %s\n", op,
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001671 op->ob_refcnt, Py_Type(op)->tp_name);
Tim Peters269b2a62003-04-17 19:52:29 +00001672}
1673
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001674PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001675_Py_GetObjects(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001676{
1677 int i, n;
1678 PyObject *t = NULL;
1679 PyObject *res, *op;
1680
1681 if (!PyArg_ParseTuple(args, "i|O", &n, &t))
1682 return NULL;
1683 op = refchain._ob_next;
1684 res = PyList_New(0);
1685 if (res == NULL)
1686 return NULL;
1687 for (i = 0; (n == 0 || i < n) && op != &refchain; i++) {
1688 while (op == self || op == args || op == res || op == t ||
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001689 (t != NULL && Py_Type(op) != (PyTypeObject *) t)) {
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001690 op = op->_ob_next;
1691 if (op == &refchain)
1692 return res;
1693 }
1694 if (PyList_Append(res, op) < 0) {
1695 Py_DECREF(res);
1696 return NULL;
1697 }
1698 op = op->_ob_next;
1699 }
1700 return res;
1701}
1702
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001703#endif
Guido van Rossum97ead3f1996-01-12 01:24:09 +00001704
1705
1706/* Hack to force loading of cobject.o */
Guido van Rossumda9c2711996-12-05 21:58:58 +00001707PyTypeObject *_Py_cobject_hack = &PyCObject_Type;
Guido van Rossum84a90321996-05-22 16:34:47 +00001708
1709
1710/* Hack to force loading of abstract.o */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001711Py_ssize_t (*_Py_abstract_hack)(PyObject *) = PyObject_Size;
Guido van Rossume09fb551997-08-05 02:04:34 +00001712
1713
Andrew M. Kuchling1582a3a2000-08-16 12:27:23 +00001714/* Python's malloc wrappers (see pymem.h) */
Guido van Rossume09fb551997-08-05 02:04:34 +00001715
Thomas Wouters334fb892000-07-25 12:56:38 +00001716void *
Fred Drake100814d2000-07-09 15:48:49 +00001717PyMem_Malloc(size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001718{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001719 return PyMem_MALLOC(nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001720}
1721
Thomas Wouters334fb892000-07-25 12:56:38 +00001722void *
1723PyMem_Realloc(void *p, size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001724{
Tim Petersaf3e8de2002-04-12 07:22:56 +00001725 return PyMem_REALLOC(p, nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001726}
1727
1728void
Thomas Wouters334fb892000-07-25 12:56:38 +00001729PyMem_Free(void *p)
Guido van Rossume09fb551997-08-05 02:04:34 +00001730{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001731 PyMem_FREE(p);
1732}
1733
1734
Guido van Rossum86610361998-04-10 22:32:46 +00001735/* These methods are used to control infinite recursion in repr, str, print,
1736 etc. Container objects that may recursively contain themselves,
1737 e.g. builtin dictionaries and lists, should used Py_ReprEnter() and
1738 Py_ReprLeave() to avoid infinite recursion.
1739
1740 Py_ReprEnter() returns 0 the first time it is called for a particular
1741 object and 1 every time thereafter. It returns -1 if an exception
1742 occurred. Py_ReprLeave() has no return value.
1743
1744 See dictobject.c and listobject.c for examples of use.
1745*/
1746
1747#define KEY "Py_Repr"
1748
1749int
Fred Drake100814d2000-07-09 15:48:49 +00001750Py_ReprEnter(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001751{
1752 PyObject *dict;
1753 PyObject *list;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001754 Py_ssize_t i;
Guido van Rossum86610361998-04-10 22:32:46 +00001755
1756 dict = PyThreadState_GetDict();
1757 if (dict == NULL)
Guido van Rossum0fc8f002003-04-15 15:12:39 +00001758 return 0;
Guido van Rossum86610361998-04-10 22:32:46 +00001759 list = PyDict_GetItemString(dict, KEY);
1760 if (list == NULL) {
1761 list = PyList_New(0);
1762 if (list == NULL)
1763 return -1;
1764 if (PyDict_SetItemString(dict, KEY, list) < 0)
1765 return -1;
1766 Py_DECREF(list);
1767 }
1768 i = PyList_GET_SIZE(list);
1769 while (--i >= 0) {
1770 if (PyList_GET_ITEM(list, i) == obj)
1771 return 1;
1772 }
1773 PyList_Append(list, obj);
1774 return 0;
1775}
1776
1777void
Fred Drake100814d2000-07-09 15:48:49 +00001778Py_ReprLeave(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001779{
1780 PyObject *dict;
1781 PyObject *list;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001782 Py_ssize_t i;
Guido van Rossum86610361998-04-10 22:32:46 +00001783
1784 dict = PyThreadState_GetDict();
Guido van Rossumeb909461998-04-11 15:17:34 +00001785 if (dict == NULL)
1786 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001787 list = PyDict_GetItemString(dict, KEY);
Guido van Rossumeb909461998-04-11 15:17:34 +00001788 if (list == NULL || !PyList_Check(list))
1789 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001790 i = PyList_GET_SIZE(list);
1791 /* Count backwards because we always expect obj to be list[-1] */
1792 while (--i >= 0) {
1793 if (PyList_GET_ITEM(list, i) == obj) {
1794 PyList_SetSlice(list, i, i + 1, NULL);
1795 break;
1796 }
1797 }
1798}
Guido van Rossumd724b232000-03-13 16:01:29 +00001799
Tim Peters803526b2002-07-07 05:13:56 +00001800/* Trashcan support. */
Guido van Rossumd724b232000-03-13 16:01:29 +00001801
Tim Peters803526b2002-07-07 05:13:56 +00001802/* Current call-stack depth of tp_dealloc calls. */
Guido van Rossumd724b232000-03-13 16:01:29 +00001803int _PyTrash_delete_nesting = 0;
Guido van Rossume92e6102000-04-24 15:40:53 +00001804
Tim Peters803526b2002-07-07 05:13:56 +00001805/* List of objects that still need to be cleaned up, singly linked via their
1806 * gc headers' gc_prev pointers.
1807 */
1808PyObject *_PyTrash_delete_later = NULL;
Guido van Rossumd724b232000-03-13 16:01:29 +00001809
Tim Peters803526b2002-07-07 05:13:56 +00001810/* Add op to the _PyTrash_delete_later list. Called when the current
1811 * call-stack depth gets large. op must be a currently untracked gc'ed
1812 * object, with refcount 0. Py_DECREF must already have been called on it.
1813 */
Guido van Rossumd724b232000-03-13 16:01:29 +00001814void
Fred Drake100814d2000-07-09 15:48:49 +00001815_PyTrash_deposit_object(PyObject *op)
Guido van Rossumd724b232000-03-13 16:01:29 +00001816{
Tim Peters803526b2002-07-07 05:13:56 +00001817 assert(PyObject_IS_GC(op));
1818 assert(_Py_AS_GC(op)->gc.gc_refs == _PyGC_REFS_UNTRACKED);
1819 assert(op->ob_refcnt == 0);
Neil Schemenauerf589c052002-03-29 03:05:54 +00001820 _Py_AS_GC(op)->gc.gc_prev = (PyGC_Head *)_PyTrash_delete_later;
Guido van Rossume92e6102000-04-24 15:40:53 +00001821 _PyTrash_delete_later = op;
Guido van Rossumd724b232000-03-13 16:01:29 +00001822}
1823
Tim Peters803526b2002-07-07 05:13:56 +00001824/* Dealloccate all the objects in the _PyTrash_delete_later list. Called when
1825 * the call-stack unwinds again.
1826 */
Guido van Rossumd724b232000-03-13 16:01:29 +00001827void
Fred Drake100814d2000-07-09 15:48:49 +00001828_PyTrash_destroy_chain(void)
Guido van Rossumd724b232000-03-13 16:01:29 +00001829{
1830 while (_PyTrash_delete_later) {
Tim Peters803526b2002-07-07 05:13:56 +00001831 PyObject *op = _PyTrash_delete_later;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001832 destructor dealloc = Py_Type(op)->tp_dealloc;
Neil Schemenauerf589c052002-03-29 03:05:54 +00001833
Neil Schemenauerf589c052002-03-29 03:05:54 +00001834 _PyTrash_delete_later =
Tim Peters803526b2002-07-07 05:13:56 +00001835 (PyObject*) _Py_AS_GC(op)->gc.gc_prev;
Neil Schemenauerf589c052002-03-29 03:05:54 +00001836
Tim Peters803526b2002-07-07 05:13:56 +00001837 /* Call the deallocator directly. This used to try to
1838 * fool Py_DECREF into calling it indirectly, but
1839 * Py_DECREF was already called on this object, and in
1840 * assorted non-release builds calling Py_DECREF again ends
1841 * up distorting allocation statistics.
1842 */
1843 assert(op->ob_refcnt == 0);
Guido van Rossumd724b232000-03-13 16:01:29 +00001844 ++_PyTrash_delete_nesting;
Tim Peters803526b2002-07-07 05:13:56 +00001845 (*dealloc)(op);
Guido van Rossumd724b232000-03-13 16:01:29 +00001846 --_PyTrash_delete_nesting;
1847 }
1848}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001849
1850#ifdef __cplusplus
1851}
1852#endif