blob: b14e52aadee1ac169324854a94a699cff35680d1 [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) */
Christian Heimes90aa7642007-12-19 02:45:37 +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;
Christian Heimes90aa7642007-12-19 02:45:37 +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;
Christian Heimes72b710a2008-05-26 13:28:38 +0000294 else if (PyBytes_Check(s)) {
295 fwrite(PyBytes_AS_STRING(s), 1,
296 PyBytes_GET_SIZE(s), fp);
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000297 }
298 else if (PyUnicode_Check(s)) {
299 PyObject *t;
300 t = _PyUnicode_AsDefaultEncodedString(s, NULL);
301 if (t == NULL)
302 ret = 0;
303 else {
Christian Heimes72b710a2008-05-26 13:28:38 +0000304 fwrite(PyBytes_AS_STRING(t), 1,
305 PyBytes_GET_SIZE(t), fp);
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000306 }
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 {
Benjamin Peterson6ebe78f2008-12-21 00:06:59 +0000347 PyGILState_STATE gil;
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000348 fprintf(stderr, "object : ");
Benjamin Peterson6ebe78f2008-12-21 00:06:59 +0000349 gil = PyGILState_Ensure();
Barry Warsaweefb1072001-02-22 22:39:18 +0000350 (void)PyObject_Print(op, stderr, 0);
Benjamin Peterson6ebe78f2008-12-21 00:06:59 +0000351 PyGILState_Release(gil);
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000352 /* XXX(twouters) cast refcount to long until %zd is
353 universally available */
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000354 fprintf(stderr, "\n"
355 "type : %s\n"
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000356 "refcount: %ld\n"
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000357 "address : %p\n",
Christian Heimes90aa7642007-12-19 02:45:37 +0000358 Py_TYPE(op)==NULL ? "NULL" : Py_TYPE(op)->tp_name,
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000359 (long)op->ob_refcnt,
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000360 op);
Barry Warsaweefb1072001-02-22 22:39:18 +0000361 }
Barry Warsaw9bf16442001-01-23 16:24:35 +0000362}
Barry Warsaw903138f2001-01-23 16:33:18 +0000363
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000364PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000365PyObject_Repr(PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000366{
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000367 PyObject *res;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000368 if (PyErr_CheckSignals())
Guido van Rossum90933611991-06-07 16:10:43 +0000369 return NULL;
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000370#ifdef USE_STACKCHECK
371 if (PyOS_CheckStack()) {
Fred Drake661ea262000-10-24 19:57:45 +0000372 PyErr_SetString(PyExc_MemoryError, "stack overflow");
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000373 return NULL;
374 }
375#endif
Guido van Rossum90933611991-06-07 16:10:43 +0000376 if (v == NULL)
Walter Dörwald1ab83302007-05-18 17:15:44 +0000377 return PyUnicode_FromString("<NULL>");
Christian Heimes90aa7642007-12-19 02:45:37 +0000378 if (Py_TYPE(v)->tp_repr == NULL)
Guido van Rossum98297ee2007-11-06 21:34:58 +0000379 return PyUnicode_FromFormat("<%s object at %p>",
380 v->ob_type->tp_name, v);
381 res = (*v->ob_type->tp_repr)(v);
382 if (res != NULL && !PyUnicode_Check(res)) {
383 PyErr_Format(PyExc_TypeError,
384 "__repr__ returned non-string (type %.200s)",
385 res->ob_type->tp_name);
386 Py_DECREF(res);
387 return NULL;
388 }
389 return res;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000390}
391
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000392PyObject *
Guido van Rossum98297ee2007-11-06 21:34:58 +0000393PyObject_Str(PyObject *v)
Guido van Rossumc6004111993-11-05 10:22:19 +0000394{
Guido van Rossum4c08d552000-03-10 22:55:18 +0000395 PyObject *res;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000396 if (PyErr_CheckSignals())
397 return NULL;
398#ifdef USE_STACKCHECK
399 if (PyOS_CheckStack()) {
400 PyErr_SetString(PyExc_MemoryError, "stack overflow");
401 return NULL;
402 }
403#endif
Guido van Rossumc6004111993-11-05 10:22:19 +0000404 if (v == NULL)
Neal Norwitz6ea45d32007-08-26 04:19:43 +0000405 return PyUnicode_FromString("<NULL>");
Neil Schemenauercf52c072005-08-12 17:34:58 +0000406 if (PyUnicode_CheckExact(v)) {
407 Py_INCREF(v);
408 return v;
409 }
Christian Heimes90aa7642007-12-19 02:45:37 +0000410 if (Py_TYPE(v)->tp_str == NULL)
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000411 return PyObject_Repr(v);
412
Guido van Rossum8ce8a782007-11-01 19:42:39 +0000413 /* It is possible for a type to have a tp_str representation that loops
414 infinitely. */
415 if (Py_EnterRecursiveCall(" while getting the str of an object"))
416 return NULL;
Christian Heimes90aa7642007-12-19 02:45:37 +0000417 res = (*Py_TYPE(v)->tp_str)(v);
Guido van Rossum8ce8a782007-11-01 19:42:39 +0000418 Py_LeaveRecursiveCall();
Guido van Rossum4c08d552000-03-10 22:55:18 +0000419 if (res == NULL)
420 return NULL;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000421 if (!PyUnicode_Check(res)) {
Neil Schemenauercf52c072005-08-12 17:34:58 +0000422 PyErr_Format(PyExc_TypeError,
423 "__str__ returned non-string (type %.200s)",
Christian Heimes90aa7642007-12-19 02:45:37 +0000424 Py_TYPE(res)->tp_name);
Neil Schemenauercf52c072005-08-12 17:34:58 +0000425 Py_DECREF(res);
426 return NULL;
427 }
428 return res;
429}
430
Georg Brandl559e5d72008-06-11 18:37:52 +0000431PyObject *
432PyObject_ASCII(PyObject *v)
433{
434 PyObject *repr, *ascii, *res;
435
436 repr = PyObject_Repr(v);
437 if (repr == NULL)
438 return NULL;
439
440 /* repr is guaranteed to be a PyUnicode object by PyObject_Repr */
441 ascii = PyUnicode_EncodeASCII(
442 PyUnicode_AS_UNICODE(repr),
443 PyUnicode_GET_SIZE(repr),
444 "backslashreplace");
445
446 Py_DECREF(repr);
447 if (ascii == NULL)
448 return NULL;
449
450 res = PyUnicode_DecodeASCII(
451 PyBytes_AS_STRING(ascii),
452 PyBytes_GET_SIZE(ascii),
453 NULL);
454
455 Py_DECREF(ascii);
456 return res;
457}
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000458
Benjamin Petersonc15a0732008-08-26 16:46:47 +0000459PyObject *
460PyObject_Bytes(PyObject *v)
461{
Christian Heimesff869fa2008-08-28 11:28:26 +0000462 PyObject *result, *func;
Benjamin Petersonc15a0732008-08-26 16:46:47 +0000463 static PyObject *bytesstring = NULL;
464
465 if (bytesstring == NULL) {
466 bytesstring = PyUnicode_InternFromString("__bytes__");
467 if (bytesstring == NULL)
468 return NULL;
469 }
470
471 if (v == NULL)
472 return PyBytes_FromString("<NULL>");
473
474 if (PyBytes_CheckExact(v)) {
475 Py_INCREF(v);
476 return v;
477 }
478
479 /* Doesn't create a reference */
480 func = _PyType_Lookup(Py_TYPE(v), bytesstring);
481 if (func != NULL) {
482 result = PyObject_CallFunctionObjArgs(func, v, NULL);
483 if (result == NULL)
484 return NULL;
485 if (!PyBytes_Check(result)) {
486 PyErr_Format(PyExc_TypeError,
487 "__bytes__ returned non-bytes (type %.200s)",
488 Py_TYPE(result)->tp_name);
489 Py_DECREF(result);
490 return NULL;
491 }
492 return result;
493 }
494 PyErr_Clear();
495 return PyBytes_FromObject(v);
496}
497
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000498/* The new comparison philosophy is: we completely separate three-way
499 comparison from rich comparison. That is, PyObject_Compare() and
500 PyObject_Cmp() *just* use the tp_compare slot. And PyObject_RichCompare()
501 and PyObject_RichCompareBool() *just* use the tp_richcompare slot.
Guido van Rossum98297ee2007-11-06 21:34:58 +0000502
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000503 See (*) below for practical amendments.
504
505 IOW, only cmp() uses tp_compare; the comparison operators (==, !=, <=, <,
506 >=, >) only use tp_richcompare. Note that list.sort() only uses <.
507
508 (And yes, eventually we'll rip out cmp() and tp_compare.)
509
510 The calling conventions are different: tp_compare only gets called with two
511 objects of the appropriate type; tp_richcompare gets called with a first
512 argument of the appropriate type and a second object of an arbitrary type.
513 We never do any kind of coercion.
514
515 The return conventions are also different.
516
517 The tp_compare slot should return a C int, as follows:
518
519 -1 if a < b or if an exception occurred
520 0 if a == b
521 +1 if a > b
522
523 No other return values are allowed. PyObject_Compare() has the same
524 calling convention.
525
526 The tp_richcompare slot should return an object, as follows:
527
528 NULL if an exception occurred
529 NotImplemented if the requested comparison is not implemented
530 any other false value if the requested comparison is false
531 any other true value if the requested comparison is true
532
533 The PyObject_RichCompare[Bool]() wrappers raise TypeError when they get
534 NotImplemented.
535
536 (*) Practical amendments:
537
538 - If rich comparison returns NotImplemented, == and != are decided by
539 comparing the object pointer (i.e. falling back to the base object
540 implementation).
541
542 - If three-way comparison is not implemented, it falls back on rich
543 comparison (but not the other way around!).
544
Guido van Rossuma4073002002-05-31 20:03:54 +0000545*/
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000546
547/* Forward */
548static PyObject *do_richcompare(PyObject *v, PyObject *w, int op);
549
550/* Perform a three-way comparison, raising TypeError if three-way comparison
551 is not supported. */
Guido van Rossuma4073002002-05-31 20:03:54 +0000552static int
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000553do_compare(PyObject *v, PyObject *w)
Guido van Rossuma4073002002-05-31 20:03:54 +0000554{
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000555 cmpfunc f;
556 int ok;
557
Guido van Rossum98297ee2007-11-06 21:34:58 +0000558 if (v->ob_type == w->ob_type &&
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000559 (f = v->ob_type->tp_compare) != NULL) {
560 return (*f)(v, w);
Guido van Rossuma4073002002-05-31 20:03:54 +0000561 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000562
563 /* Now try three-way compare before giving up. This is intentionally
564 elaborate; if you have a it will raise TypeError if it detects two
565 objects that aren't ordered with respect to each other. */
566 ok = PyObject_RichCompareBool(v, w, Py_LT);
567 if (ok < 0)
568 return -1; /* Error */
569 if (ok)
570 return -1; /* Less than */
571 ok = PyObject_RichCompareBool(v, w, Py_GT);
572 if (ok < 0)
573 return -1; /* Error */
574 if (ok)
575 return 1; /* Greater than */
576 ok = PyObject_RichCompareBool(v, w, Py_EQ);
577 if (ok < 0)
578 return -1; /* Error */
579 if (ok)
580 return 0; /* Equal */
581
582 /* Give up */
583 PyErr_Format(PyExc_TypeError,
Neal Norwitz3bd844e2006-08-29 04:39:12 +0000584 "unorderable types: '%.100s' != '%.100s'",
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000585 v->ob_type->tp_name,
586 w->ob_type->tp_name);
587 return -1;
Guido van Rossuma4073002002-05-31 20:03:54 +0000588}
589
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000590/* Perform a three-way comparison. This wraps do_compare() with a check for
591 NULL arguments and a recursion check. */
592int
593PyObject_Compare(PyObject *v, PyObject *w)
594{
595 int res;
Guido van Rossuma4073002002-05-31 20:03:54 +0000596
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000597 if (v == NULL || w == NULL) {
598 if (!PyErr_Occurred())
599 PyErr_BadInternalCall();
600 return -1;
601 }
602 if (Py_EnterRecursiveCall(" in cmp"))
603 return -1;
604 res = do_compare(v, w);
605 Py_LeaveRecursiveCall();
606 return res < 0 ? -1 : res;
607}
Guido van Rossumd1f06b92001-01-24 22:14:43 +0000608
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000609/* Map rich comparison operators to their swapped version, e.g. LT <--> GT */
Brett Cannona5ca2e72004-09-25 01:37:24 +0000610int _Py_SwappedOp[] = {Py_GT, Py_GE, Py_EQ, Py_NE, Py_LT, Py_LE};
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000611
Guido van Rossum9a4e95c2006-12-19 21:35:46 +0000612static char *opstrings[] = {"<", "<=", "==", "!=", ">", ">="};
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000613
614/* Perform a rich comparison, raising TypeError when the requested comparison
615 operator is not supported. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000616static PyObject *
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000617do_richcompare(PyObject *v, PyObject *w, int op)
Guido van Rossume797ec12001-01-17 15:24:28 +0000618{
619 richcmpfunc f;
620 PyObject *res;
621
Guido van Rossum2ed6bf82001-09-27 20:30:07 +0000622 if (v->ob_type != w->ob_type &&
623 PyType_IsSubtype(w->ob_type, v->ob_type) &&
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000624 (f = w->ob_type->tp_richcompare) != NULL) {
Tim Petersf4aca752004-09-23 02:39:37 +0000625 res = (*f)(w, v, _Py_SwappedOp[op]);
Guido van Rossum2ed6bf82001-09-27 20:30:07 +0000626 if (res != Py_NotImplemented)
627 return res;
628 Py_DECREF(res);
629 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000630 if ((f = v->ob_type->tp_richcompare) != NULL) {
Guido van Rossume797ec12001-01-17 15:24:28 +0000631 res = (*f)(v, w, op);
632 if (res != Py_NotImplemented)
633 return res;
634 Py_DECREF(res);
635 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000636 if ((f = w->ob_type->tp_richcompare) != NULL) {
637 res = (*f)(w, v, _Py_SwappedOp[op]);
638 if (res != Py_NotImplemented)
639 return res;
640 Py_DECREF(res);
Guido van Rossume797ec12001-01-17 15:24:28 +0000641 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000642 /* If neither object implements it, provide a sensible default
643 for == and !=, but raise an exception for ordering. */
644 switch (op) {
645 case Py_EQ:
646 res = (v == w) ? Py_True : Py_False;
647 break;
648 case Py_NE:
649 res = (v != w) ? Py_True : Py_False;
650 break;
651 default:
Guido van Rossum9a4e95c2006-12-19 21:35:46 +0000652 /* XXX Special-case None so it doesn't show as NoneType() */
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000653 PyErr_Format(PyExc_TypeError,
654 "unorderable types: %.100s() %s %.100s()",
655 v->ob_type->tp_name,
656 opstrings[op],
657 w->ob_type->tp_name);
658 return NULL;
659 }
Guido van Rossume797ec12001-01-17 15:24:28 +0000660 Py_INCREF(res);
661 return res;
662}
663
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000664/* Perform a rich comparison with object result. This wraps do_richcompare()
665 with a check for NULL arguments and a recursion check. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000666
Guido van Rossume797ec12001-01-17 15:24:28 +0000667PyObject *
668PyObject_RichCompare(PyObject *v, PyObject *w, int op)
669{
670 PyObject *res;
671
672 assert(Py_LT <= op && op <= Py_GE);
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000673 if (v == NULL || w == NULL) {
674 if (!PyErr_Occurred())
675 PyErr_BadInternalCall();
676 return NULL;
677 }
Armin Rigo2b3eb402003-10-28 12:05:48 +0000678 if (Py_EnterRecursiveCall(" in cmp"))
679 return NULL;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000680 res = do_richcompare(v, w, op);
Armin Rigo2b3eb402003-10-28 12:05:48 +0000681 Py_LeaveRecursiveCall();
Guido van Rossume797ec12001-01-17 15:24:28 +0000682 return res;
683}
684
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000685/* Perform a rich comparison with integer result. This wraps
686 PyObject_RichCompare(), returning -1 for error, 0 for false, 1 for true. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000687int
688PyObject_RichCompareBool(PyObject *v, PyObject *w, int op)
689{
Raymond Hettinger93d44812004-03-21 17:01:44 +0000690 PyObject *res;
Guido van Rossume797ec12001-01-17 15:24:28 +0000691 int ok;
692
Mark Dickinson4a1f5932008-11-12 23:23:36 +0000693 /* Quick result when objects are the same.
694 Guarantees that identity implies equality. */
695 if (v == w) {
696 if (op == Py_EQ)
697 return 1;
698 else if (op == Py_NE)
699 return 0;
700 }
701
Raymond Hettinger93d44812004-03-21 17:01:44 +0000702 res = PyObject_RichCompare(v, w, op);
Guido van Rossume797ec12001-01-17 15:24:28 +0000703 if (res == NULL)
704 return -1;
Guido van Rossum81912d42002-08-24 05:33:28 +0000705 if (PyBool_Check(res))
706 ok = (res == Py_True);
707 else
708 ok = PyObject_IsTrue(res);
Guido van Rossume797ec12001-01-17 15:24:28 +0000709 Py_DECREF(res);
710 return ok;
711}
Fred Drake13634cf2000-06-29 19:17:04 +0000712
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000713/* Turn the result of a three-way comparison into the result expected by a
714 rich comparison. */
715PyObject *
716Py_CmpToRich(int op, int cmp)
717{
718 PyObject *res;
719 int ok;
720
721 if (PyErr_Occurred())
722 return NULL;
723 switch (op) {
724 case Py_LT:
Guido van Rossum98297ee2007-11-06 21:34:58 +0000725 ok = cmp < 0;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000726 break;
727 case Py_LE:
Guido van Rossum98297ee2007-11-06 21:34:58 +0000728 ok = cmp <= 0;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000729 break;
730 case Py_EQ:
Guido van Rossum98297ee2007-11-06 21:34:58 +0000731 ok = cmp == 0;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000732 break;
733 case Py_NE:
Guido van Rossum98297ee2007-11-06 21:34:58 +0000734 ok = cmp != 0;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000735 break;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000736 case Py_GT:
737 ok = cmp > 0;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000738 break;
739 case Py_GE:
Guido van Rossum98297ee2007-11-06 21:34:58 +0000740 ok = cmp >= 0;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000741 break;
742 default:
Guido van Rossum98297ee2007-11-06 21:34:58 +0000743 PyErr_BadArgument();
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000744 return NULL;
745 }
746 res = ok ? Py_True : Py_False;
747 Py_INCREF(res);
748 return res;
749}
750
Fred Drake13634cf2000-06-29 19:17:04 +0000751/* Set of hash utility functions to help maintaining the invariant that
Raymond Hettinger8183fa42004-03-21 17:35:06 +0000752 if a==b then hash(a)==hash(b)
Fred Drake13634cf2000-06-29 19:17:04 +0000753
754 All the utility functions (_Py_Hash*()) return "-1" to signify an error.
755*/
756
757long
Fred Drake100814d2000-07-09 15:48:49 +0000758_Py_HashDouble(double v)
Fred Drake13634cf2000-06-29 19:17:04 +0000759{
Tim Peters39dce292000-08-15 03:34:48 +0000760 double intpart, fractpart;
761 int expo;
762 long hipart;
763 long x; /* the final hash value */
764 /* This is designed so that Python numbers of different types
765 * that compare equal hash to the same value; otherwise comparisons
766 * of mapping keys will turn out weird.
767 */
768
Tim Peters39dce292000-08-15 03:34:48 +0000769 fractpart = modf(v, &intpart);
Tim Peters39dce292000-08-15 03:34:48 +0000770 if (fractpart == 0.0) {
771 /* This must return the same hash as an equal int or long. */
772 if (intpart > LONG_MAX || -intpart > LONG_MAX) {
773 /* Convert to long and use its hash. */
774 PyObject *plong; /* converted to Python long */
775 if (Py_IS_INFINITY(intpart))
776 /* can't convert to long int -- arbitrary */
777 v = v < 0 ? -271828.0 : 314159.0;
778 plong = PyLong_FromDouble(v);
779 if (plong == NULL)
780 return -1;
781 x = PyObject_Hash(plong);
782 Py_DECREF(plong);
783 return x;
784 }
785 /* Fits in a C long == a Python int, so is its own hash. */
786 x = (long)intpart;
787 if (x == -1)
788 x = -2;
789 return x;
790 }
791 /* The fractional part is non-zero, so we don't have to worry about
792 * making this match the hash of some other type.
793 * Use frexp to get at the bits in the double.
Fred Drake13634cf2000-06-29 19:17:04 +0000794 * Since the VAX D double format has 56 mantissa bits, which is the
795 * most of any double format in use, each of these parts may have as
796 * many as (but no more than) 56 significant bits.
Tim Peters39dce292000-08-15 03:34:48 +0000797 * So, assuming sizeof(long) >= 4, each part can be broken into two
798 * longs; frexp and multiplication are used to do that.
799 * Also, since the Cray double format has 15 exponent bits, which is
800 * the most of any double format in use, shifting the exponent field
801 * left by 15 won't overflow a long (again assuming sizeof(long) >= 4).
Fred Drake13634cf2000-06-29 19:17:04 +0000802 */
Tim Peters39dce292000-08-15 03:34:48 +0000803 v = frexp(v, &expo);
804 v *= 2147483648.0; /* 2**31 */
805 hipart = (long)v; /* take the top 32 bits */
806 v = (v - (double)hipart) * 2147483648.0; /* get the next 32 bits */
807 x = hipart + (long)v + (expo << 15);
808 if (x == -1)
809 x = -2;
810 return x;
Fred Drake13634cf2000-06-29 19:17:04 +0000811}
812
813long
Fred Drake100814d2000-07-09 15:48:49 +0000814_Py_HashPointer(void *p)
Fred Drake13634cf2000-06-29 19:17:04 +0000815{
816#if SIZEOF_LONG >= SIZEOF_VOID_P
817 return (long)p;
818#else
819 /* convert to a Python long and hash that */
820 PyObject* longobj;
821 long x;
Tim Peters803526b2002-07-07 05:13:56 +0000822
Fred Drake13634cf2000-06-29 19:17:04 +0000823 if ((longobj = PyLong_FromVoidPtr(p)) == NULL) {
824 x = -1;
825 goto finally;
826 }
827 x = PyObject_Hash(longobj);
Tim Peters803526b2002-07-07 05:13:56 +0000828
Fred Drake13634cf2000-06-29 19:17:04 +0000829finally:
830 Py_XDECREF(longobj);
831 return x;
832#endif
833}
834
Nick Coghland1abd252008-07-15 15:46:38 +0000835long
836PyObject_HashNotImplemented(PyObject *v)
837{
838 PyErr_Format(PyExc_TypeError, "unhashable type: '%.200s'",
839 Py_TYPE(v)->tp_name);
840 return -1;
841}
Fred Drake13634cf2000-06-29 19:17:04 +0000842
Guido van Rossum9bfef441993-03-29 10:43:31 +0000843long
Fred Drake100814d2000-07-09 15:48:49 +0000844PyObject_Hash(PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000845{
Nick Coghland1abd252008-07-15 15:46:38 +0000846 PyTypeObject *tp = Py_TYPE(v);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000847 if (tp->tp_hash != NULL)
848 return (*tp->tp_hash)(v);
Guido van Rossum50e9fb92006-08-17 05:42:55 +0000849 /* Otherwise, the object can't be hashed */
Nick Coghland1abd252008-07-15 15:46:38 +0000850 return PyObject_HashNotImplemented(v);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000851}
852
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000853PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000854PyObject_GetAttrString(PyObject *v, const char *name)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000855{
Tim Peters6d6c1a32001-08-02 04:15:00 +0000856 PyObject *w, *res;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000857
Christian Heimes90aa7642007-12-19 02:45:37 +0000858 if (Py_TYPE(v)->tp_getattr != NULL)
859 return (*Py_TYPE(v)->tp_getattr)(v, (char*)name);
Martin v. Löwis5b222132007-06-10 09:51:05 +0000860 w = PyUnicode_InternFromString(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000861 if (w == NULL)
862 return NULL;
863 res = PyObject_GetAttr(v, w);
864 Py_XDECREF(w);
865 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000866}
867
868int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000869PyObject_HasAttrString(PyObject *v, const char *name)
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000870{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000871 PyObject *res = PyObject_GetAttrString(v, name);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000872 if (res != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000873 Py_DECREF(res);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000874 return 1;
875 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000876 PyErr_Clear();
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000877 return 0;
878}
879
880int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000881PyObject_SetAttrString(PyObject *v, const char *name, PyObject *w)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000882{
Tim Peters6d6c1a32001-08-02 04:15:00 +0000883 PyObject *s;
884 int res;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000885
Christian Heimes90aa7642007-12-19 02:45:37 +0000886 if (Py_TYPE(v)->tp_setattr != NULL)
887 return (*Py_TYPE(v)->tp_setattr)(v, (char*)name, w);
Martin v. Löwis5b222132007-06-10 09:51:05 +0000888 s = PyUnicode_InternFromString(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000889 if (s == NULL)
890 return -1;
891 res = PyObject_SetAttr(v, s, w);
892 Py_XDECREF(s);
893 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000894}
895
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000896PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000897PyObject_GetAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000898{
Christian Heimes90aa7642007-12-19 02:45:37 +0000899 PyTypeObject *tp = Py_TYPE(v);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000900
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000901 if (!PyUnicode_Check(name)) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000902 PyErr_Format(PyExc_TypeError,
903 "attribute name must be string, not '%.200s'",
904 name->ob_type->tp_name);
905 return NULL;
Jeremy Hylton99a8f902000-06-23 14:36:32 +0000906 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000907 if (tp->tp_getattro != NULL)
908 return (*tp->tp_getattro)(v, name);
909 if (tp->tp_getattr != NULL)
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000910 return (*tp->tp_getattr)(v, _PyUnicode_AsString(name));
Tim Peters6d6c1a32001-08-02 04:15:00 +0000911 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000912 "'%.50s' object has no attribute '%U'",
913 tp->tp_name, name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000914 return NULL;
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000915}
916
917int
Fred Drake100814d2000-07-09 15:48:49 +0000918PyObject_HasAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000919{
920 PyObject *res = PyObject_GetAttr(v, name);
921 if (res != NULL) {
922 Py_DECREF(res);
923 return 1;
924 }
925 PyErr_Clear();
926 return 0;
927}
928
929int
Fred Drake100814d2000-07-09 15:48:49 +0000930PyObject_SetAttr(PyObject *v, PyObject *name, PyObject *value)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000931{
Christian Heimes90aa7642007-12-19 02:45:37 +0000932 PyTypeObject *tp = Py_TYPE(v);
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000933 int err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000934
Martin v. Löwis5b222132007-06-10 09:51:05 +0000935 if (!PyUnicode_Check(name)) {
936 PyErr_Format(PyExc_TypeError,
937 "attribute name must be string, not '%.200s'",
938 name->ob_type->tp_name);
939 return -1;
Jeremy Hylton99a8f902000-06-23 14:36:32 +0000940 }
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000941 Py_INCREF(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000942
Martin v. Löwis5b222132007-06-10 09:51:05 +0000943 PyUnicode_InternInPlace(&name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000944 if (tp->tp_setattro != NULL) {
945 err = (*tp->tp_setattro)(v, name, value);
946 Py_DECREF(name);
947 return err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000948 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000949 if (tp->tp_setattr != NULL) {
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +0000950 err = (*tp->tp_setattr)(v, _PyUnicode_AsString(name), value);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000951 Py_DECREF(name);
952 return err;
953 }
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000954 Py_DECREF(name);
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000955 assert(name->ob_refcnt >= 1);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000956 if (tp->tp_getattr == NULL && tp->tp_getattro == NULL)
957 PyErr_Format(PyExc_TypeError,
958 "'%.100s' object has no attributes "
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000959 "(%s .%U)",
Tim Peters6d6c1a32001-08-02 04:15:00 +0000960 tp->tp_name,
961 value==NULL ? "del" : "assign to",
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000962 name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000963 else
964 PyErr_Format(PyExc_TypeError,
965 "'%.100s' object has only read-only attributes "
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000966 "(%s .%U)",
Tim Peters6d6c1a32001-08-02 04:15:00 +0000967 tp->tp_name,
968 value==NULL ? "del" : "assign to",
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000969 name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000970 return -1;
971}
972
973/* Helper to get a pointer to an object's __dict__ slot, if any */
974
975PyObject **
976_PyObject_GetDictPtr(PyObject *obj)
977{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000978 Py_ssize_t dictoffset;
Christian Heimes90aa7642007-12-19 02:45:37 +0000979 PyTypeObject *tp = Py_TYPE(obj);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000980
Tim Peters6d6c1a32001-08-02 04:15:00 +0000981 dictoffset = tp->tp_dictoffset;
982 if (dictoffset == 0)
983 return NULL;
984 if (dictoffset < 0) {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000985 Py_ssize_t tsize;
Guido van Rossum2eb0b872002-03-01 22:24:49 +0000986 size_t size;
987
988 tsize = ((PyVarObject *)obj)->ob_size;
989 if (tsize < 0)
990 tsize = -tsize;
991 size = _PyObject_VAR_SIZE(tp, tsize);
992
Tim Peters6d483d32001-10-06 21:27:34 +0000993 dictoffset += (long)size;
994 assert(dictoffset > 0);
995 assert(dictoffset % SIZEOF_VOID_P == 0);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000996 }
997 return (PyObject **) ((char *)obj + dictoffset);
998}
999
Tim Peters6d6c1a32001-08-02 04:15:00 +00001000PyObject *
Raymond Hettinger1da1dbf2003-03-17 19:46:11 +00001001PyObject_SelfIter(PyObject *obj)
Raymond Hettinger01538262003-03-17 08:24:35 +00001002{
1003 Py_INCREF(obj);
1004 return obj;
1005}
1006
Michael W. Hudson1593f502004-09-14 17:09:47 +00001007/* Generic GetAttr functions - put these in your tp_[gs]etattro slot */
1008
Raymond Hettinger01538262003-03-17 08:24:35 +00001009PyObject *
Tim Peters6d6c1a32001-08-02 04:15:00 +00001010PyObject_GenericGetAttr(PyObject *obj, PyObject *name)
1011{
Christian Heimes90aa7642007-12-19 02:45:37 +00001012 PyTypeObject *tp = Py_TYPE(obj);
Guido van Rossum056fbf42002-08-19 19:22:50 +00001013 PyObject *descr = NULL;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001014 PyObject *res = NULL;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001015 descrgetfunc f;
Martin v. Löwis725507b2006-03-07 12:08:51 +00001016 Py_ssize_t dictoffset;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001017 PyObject **dictptr;
1018
Martin v. Löwis5b222132007-06-10 09:51:05 +00001019 if (!PyUnicode_Check(name)){
1020 PyErr_Format(PyExc_TypeError,
1021 "attribute name must be string, not '%.200s'",
1022 name->ob_type->tp_name);
1023 return NULL;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001024 }
1025 else
1026 Py_INCREF(name);
1027
Tim Peters6d6c1a32001-08-02 04:15:00 +00001028 if (tp->tp_dict == NULL) {
Guido van Rossum528b7eb2001-08-07 17:24:28 +00001029 if (PyType_Ready(tp) < 0)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001030 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001031 }
1032
Christian Heimesa62da1d2008-01-12 19:39:10 +00001033#if 0 /* XXX this is not quite _PyType_Lookup anymore */
Guido van Rossum056fbf42002-08-19 19:22:50 +00001034 /* Inline _PyType_Lookup */
1035 {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001036 Py_ssize_t i, n;
Guido van Rossum056fbf42002-08-19 19:22:50 +00001037 PyObject *mro, *base, *dict;
1038
1039 /* Look in tp_dict of types in MRO */
1040 mro = tp->tp_mro;
1041 assert(mro != NULL);
1042 assert(PyTuple_Check(mro));
1043 n = PyTuple_GET_SIZE(mro);
1044 for (i = 0; i < n; i++) {
1045 base = PyTuple_GET_ITEM(mro, i);
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001046 assert(PyType_Check(base));
1047 dict = ((PyTypeObject *)base)->tp_dict;
Guido van Rossum056fbf42002-08-19 19:22:50 +00001048 assert(dict && PyDict_Check(dict));
1049 descr = PyDict_GetItem(dict, name);
1050 if (descr != NULL)
1051 break;
1052 }
1053 }
Christian Heimesa62da1d2008-01-12 19:39:10 +00001054#else
1055 descr = _PyType_Lookup(tp, name);
1056#endif
Guido van Rossum056fbf42002-08-19 19:22:50 +00001057
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001058 Py_XINCREF(descr);
1059
Tim Peters6d6c1a32001-08-02 04:15:00 +00001060 f = NULL;
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00001061 if (descr != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001062 f = descr->ob_type->tp_descr_get;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001063 if (f != NULL && PyDescr_IsData(descr)) {
1064 res = f(descr, obj, (PyObject *)obj->ob_type);
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001065 Py_DECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001066 goto done;
1067 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001068 }
1069
Guido van Rossumc66ff442002-08-19 16:50:48 +00001070 /* Inline _PyObject_GetDictPtr */
1071 dictoffset = tp->tp_dictoffset;
1072 if (dictoffset != 0) {
1073 PyObject *dict;
1074 if (dictoffset < 0) {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001075 Py_ssize_t tsize;
Guido van Rossumc66ff442002-08-19 16:50:48 +00001076 size_t size;
1077
1078 tsize = ((PyVarObject *)obj)->ob_size;
1079 if (tsize < 0)
1080 tsize = -tsize;
1081 size = _PyObject_VAR_SIZE(tp, tsize);
1082
1083 dictoffset += (long)size;
1084 assert(dictoffset > 0);
1085 assert(dictoffset % SIZEOF_VOID_P == 0);
1086 }
1087 dictptr = (PyObject **) ((char *)obj + dictoffset);
1088 dict = *dictptr;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001089 if (dict != NULL) {
Christian Heimes969fe572008-01-25 11:23:10 +00001090 Py_INCREF(dict);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001091 res = PyDict_GetItem(dict, name);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001092 if (res != NULL) {
1093 Py_INCREF(res);
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001094 Py_XDECREF(descr);
Christian Heimes969fe572008-01-25 11:23:10 +00001095 Py_DECREF(dict);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001096 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001097 }
Christian Heimes969fe572008-01-25 11:23:10 +00001098 Py_DECREF(dict);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001099 }
1100 }
1101
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001102 if (f != NULL) {
Christian Heimes90aa7642007-12-19 02:45:37 +00001103 res = f(descr, obj, (PyObject *)Py_TYPE(obj));
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001104 Py_DECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001105 goto done;
1106 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001107
1108 if (descr != NULL) {
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001109 res = descr;
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001110 /* descr was already increfed above */
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001111 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001112 }
1113
1114 PyErr_Format(PyExc_AttributeError,
1115 "'%.50s' object has no attribute '%.400s'",
Marc-André Lemburg4cc0f242008-08-07 18:54:33 +00001116 tp->tp_name, _PyUnicode_AsString(name));
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001117 done:
1118 Py_DECREF(name);
1119 return res;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001120}
1121
1122int
1123PyObject_GenericSetAttr(PyObject *obj, PyObject *name, PyObject *value)
1124{
Christian Heimes90aa7642007-12-19 02:45:37 +00001125 PyTypeObject *tp = Py_TYPE(obj);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001126 PyObject *descr;
1127 descrsetfunc f;
1128 PyObject **dictptr;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001129 int res = -1;
1130
Martin v. Löwis5b222132007-06-10 09:51:05 +00001131 if (!PyUnicode_Check(name)){
1132 PyErr_Format(PyExc_TypeError,
1133 "attribute name must be string, not '%.200s'",
1134 name->ob_type->tp_name);
1135 return -1;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001136 }
1137 else
1138 Py_INCREF(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001139
1140 if (tp->tp_dict == NULL) {
Guido van Rossum528b7eb2001-08-07 17:24:28 +00001141 if (PyType_Ready(tp) < 0)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001142 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001143 }
1144
1145 descr = _PyType_Lookup(tp, name);
1146 f = NULL;
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00001147 if (descr != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001148 f = descr->ob_type->tp_descr_set;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001149 if (f != NULL && PyDescr_IsData(descr)) {
1150 res = f(descr, obj, value);
1151 goto done;
1152 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001153 }
1154
1155 dictptr = _PyObject_GetDictPtr(obj);
1156 if (dictptr != NULL) {
1157 PyObject *dict = *dictptr;
1158 if (dict == NULL && value != NULL) {
1159 dict = PyDict_New();
1160 if (dict == NULL)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001161 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001162 *dictptr = dict;
1163 }
1164 if (dict != NULL) {
Christian Heimes969fe572008-01-25 11:23:10 +00001165 Py_INCREF(dict);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001166 if (value == NULL)
1167 res = PyDict_DelItem(dict, name);
1168 else
1169 res = PyDict_SetItem(dict, name, value);
1170 if (res < 0 && PyErr_ExceptionMatches(PyExc_KeyError))
1171 PyErr_SetObject(PyExc_AttributeError, name);
Christian Heimes969fe572008-01-25 11:23:10 +00001172 Py_DECREF(dict);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001173 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001174 }
1175 }
1176
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001177 if (f != NULL) {
1178 res = f(descr, obj, value);
1179 goto done;
1180 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001181
1182 if (descr == NULL) {
1183 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +00001184 "'%.100s' object has no attribute '%U'",
1185 tp->tp_name, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001186 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001187 }
1188
1189 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +00001190 "'%.50s' object attribute '%U' is read-only",
1191 tp->tp_name, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001192 done:
1193 Py_DECREF(name);
1194 return res;
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001195}
1196
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001197/* Test a value used as condition, e.g., in a for or if statement.
1198 Return -1 if an error occurred */
1199
1200int
Fred Drake100814d2000-07-09 15:48:49 +00001201PyObject_IsTrue(PyObject *v)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001202{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001203 Py_ssize_t res;
Guido van Rossum6248f442002-08-24 06:31:34 +00001204 if (v == Py_True)
1205 return 1;
1206 if (v == Py_False)
1207 return 0;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001208 if (v == Py_None)
Neal Norwitz51290d32002-06-13 21:32:44 +00001209 return 0;
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001210 else if (v->ob_type->tp_as_number != NULL &&
Jack Diederich4dafcc42006-11-28 19:15:13 +00001211 v->ob_type->tp_as_number->nb_bool != NULL)
1212 res = (*v->ob_type->tp_as_number->nb_bool)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001213 else if (v->ob_type->tp_as_mapping != NULL &&
1214 v->ob_type->tp_as_mapping->mp_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001215 res = (*v->ob_type->tp_as_mapping->mp_length)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001216 else if (v->ob_type->tp_as_sequence != NULL &&
1217 v->ob_type->tp_as_sequence->sq_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001218 res = (*v->ob_type->tp_as_sequence->sq_length)(v);
1219 else
Neal Norwitz51290d32002-06-13 21:32:44 +00001220 return 1;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001221 /* if it is negative, it should be either -1 or -2 */
1222 return (res > 0) ? 1 : Py_SAFE_DOWNCAST(res, Py_ssize_t, int);
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001223}
1224
Tim Peters803526b2002-07-07 05:13:56 +00001225/* equivalent of 'not v'
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001226 Return -1 if an error occurred */
1227
1228int
Fred Drake100814d2000-07-09 15:48:49 +00001229PyObject_Not(PyObject *v)
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001230{
1231 int res;
1232 res = PyObject_IsTrue(v);
1233 if (res < 0)
1234 return res;
1235 return res == 0;
1236}
1237
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001238/* Test whether an object can be called */
1239
1240int
Fred Drake100814d2000-07-09 15:48:49 +00001241PyCallable_Check(PyObject *x)
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001242{
1243 if (x == NULL)
1244 return 0;
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001245 return x->ob_type->tp_call != NULL;
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001246}
1247
Georg Brandle32b4222007-03-10 22:13:27 +00001248/* ------------------------- PyObject_Dir() helpers ------------------------- */
1249
Tim Peters7eea37e2001-09-04 22:08:56 +00001250/* Helper for PyObject_Dir.
1251 Merge the __dict__ of aclass into dict, and recursively also all
1252 the __dict__s of aclass's base classes. The order of merging isn't
1253 defined, as it's expected that only the final set of dict keys is
1254 interesting.
1255 Return 0 on success, -1 on error.
1256*/
1257
1258static int
1259merge_class_dict(PyObject* dict, PyObject* aclass)
1260{
1261 PyObject *classdict;
1262 PyObject *bases;
1263
1264 assert(PyDict_Check(dict));
1265 assert(aclass);
1266
1267 /* Merge in the type's dict (if any). */
1268 classdict = PyObject_GetAttrString(aclass, "__dict__");
1269 if (classdict == NULL)
1270 PyErr_Clear();
1271 else {
1272 int status = PyDict_Update(dict, classdict);
1273 Py_DECREF(classdict);
1274 if (status < 0)
1275 return -1;
1276 }
1277
1278 /* Recursively merge in the base types' (if any) dicts. */
1279 bases = PyObject_GetAttrString(aclass, "__bases__");
Tim Petersbc7e8632001-09-16 20:33:22 +00001280 if (bases == NULL)
1281 PyErr_Clear();
1282 else {
Guido van Rossum44022412002-05-13 18:29:46 +00001283 /* We have no guarantee that bases is a real tuple */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001284 Py_ssize_t i, n;
Guido van Rossum44022412002-05-13 18:29:46 +00001285 n = PySequence_Size(bases); /* This better be right */
1286 if (n < 0)
1287 PyErr_Clear();
1288 else {
1289 for (i = 0; i < n; i++) {
Tim Peters18e70832003-02-05 19:35:19 +00001290 int status;
Guido van Rossum44022412002-05-13 18:29:46 +00001291 PyObject *base = PySequence_GetItem(bases, i);
1292 if (base == NULL) {
1293 Py_DECREF(bases);
1294 return -1;
1295 }
Tim Peters18e70832003-02-05 19:35:19 +00001296 status = merge_class_dict(dict, base);
1297 Py_DECREF(base);
1298 if (status < 0) {
Guido van Rossum44022412002-05-13 18:29:46 +00001299 Py_DECREF(bases);
1300 return -1;
1301 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001302 }
1303 }
1304 Py_DECREF(bases);
1305 }
1306 return 0;
1307}
1308
Georg Brandle32b4222007-03-10 22:13:27 +00001309/* Helper for PyObject_Dir without arguments: returns the local scope. */
1310static PyObject *
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001311_dir_locals(void)
Tim Peters305b5852001-09-17 02:38:46 +00001312{
Georg Brandled3b8382007-03-12 13:15:14 +00001313 PyObject *names;
Georg Brandle32b4222007-03-10 22:13:27 +00001314 PyObject *locals = PyEval_GetLocals();
Tim Peters305b5852001-09-17 02:38:46 +00001315
Georg Brandle32b4222007-03-10 22:13:27 +00001316 if (locals == NULL) {
1317 PyErr_SetString(PyExc_SystemError, "frame does not exist");
1318 return NULL;
Tim Peters305b5852001-09-17 02:38:46 +00001319 }
1320
Georg Brandled3b8382007-03-12 13:15:14 +00001321 names = PyMapping_Keys(locals);
1322 if (!names)
1323 return NULL;
1324 if (!PyList_Check(names)) {
1325 PyErr_Format(PyExc_TypeError,
1326 "dir(): expected keys() of locals to be a list, "
Christian Heimes90aa7642007-12-19 02:45:37 +00001327 "not '%.200s'", Py_TYPE(names)->tp_name);
Georg Brandled3b8382007-03-12 13:15:14 +00001328 Py_DECREF(names);
1329 return NULL;
1330 }
Georg Brandle32b4222007-03-10 22:13:27 +00001331 /* the locals don't need to be DECREF'd */
Georg Brandled3b8382007-03-12 13:15:14 +00001332 return names;
Georg Brandle32b4222007-03-10 22:13:27 +00001333}
1334
1335/* Helper for PyObject_Dir of type objects: returns __dict__ and __bases__.
Guido van Rossum98297ee2007-11-06 21:34:58 +00001336 We deliberately don't suck up its __class__, as methods belonging to the
1337 metaclass would probably be more confusing than helpful.
Georg Brandle32b4222007-03-10 22:13:27 +00001338*/
Guido van Rossum98297ee2007-11-06 21:34:58 +00001339static PyObject *
Georg Brandle32b4222007-03-10 22:13:27 +00001340_specialized_dir_type(PyObject *obj)
1341{
1342 PyObject *result = NULL;
1343 PyObject *dict = PyDict_New();
1344
1345 if (dict != NULL && merge_class_dict(dict, obj) == 0)
1346 result = PyDict_Keys(dict);
1347
1348 Py_XDECREF(dict);
Tim Peters305b5852001-09-17 02:38:46 +00001349 return result;
1350}
1351
Georg Brandle32b4222007-03-10 22:13:27 +00001352/* Helper for PyObject_Dir of module objects: returns the module's __dict__. */
1353static PyObject *
1354_specialized_dir_module(PyObject *obj)
Tim Peters7eea37e2001-09-04 22:08:56 +00001355{
Georg Brandle32b4222007-03-10 22:13:27 +00001356 PyObject *result = NULL;
1357 PyObject *dict = PyObject_GetAttrString(obj, "__dict__");
Tim Peters7eea37e2001-09-04 22:08:56 +00001358
Georg Brandle32b4222007-03-10 22:13:27 +00001359 if (dict != NULL) {
1360 if (PyDict_Check(dict))
1361 result = PyDict_Keys(dict);
1362 else {
1363 PyErr_Format(PyExc_TypeError,
1364 "%.200s.__dict__ is not a dictionary",
1365 PyModule_GetName(obj));
Guido van Rossum8dbd3d82001-09-10 18:27:43 +00001366 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001367 }
1368
Georg Brandle32b4222007-03-10 22:13:27 +00001369 Py_XDECREF(dict);
1370 return result;
1371}
Tim Peters7eea37e2001-09-04 22:08:56 +00001372
Georg Brandle32b4222007-03-10 22:13:27 +00001373/* Helper for PyObject_Dir of generic objects: returns __dict__, __class__,
1374 and recursively up the __class__.__bases__ chain.
1375*/
1376static PyObject *
1377_generic_dir(PyObject *obj)
1378{
1379 PyObject *result = NULL;
1380 PyObject *dict = NULL;
1381 PyObject *itsclass = NULL;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001382
Georg Brandle32b4222007-03-10 22:13:27 +00001383 /* Get __dict__ (which may or may not be a real dict...) */
1384 dict = PyObject_GetAttrString(obj, "__dict__");
1385 if (dict == NULL) {
1386 PyErr_Clear();
1387 dict = PyDict_New();
1388 }
1389 else if (!PyDict_Check(dict)) {
1390 Py_DECREF(dict);
1391 dict = PyDict_New();
1392 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001393 else {
Georg Brandle32b4222007-03-10 22:13:27 +00001394 /* Copy __dict__ to avoid mutating it. */
1395 PyObject *temp = PyDict_Copy(dict);
1396 Py_DECREF(dict);
1397 dict = temp;
Tim Peters7eea37e2001-09-04 22:08:56 +00001398 }
1399
Georg Brandle32b4222007-03-10 22:13:27 +00001400 if (dict == NULL)
Raymond Hettinger2a7dede2004-08-07 04:55:30 +00001401 goto error;
Tim Peters7eea37e2001-09-04 22:08:56 +00001402
Georg Brandle32b4222007-03-10 22:13:27 +00001403 /* Merge in attrs reachable from its class. */
1404 itsclass = PyObject_GetAttrString(obj, "__class__");
1405 if (itsclass == NULL)
1406 /* XXX(tomer): Perhaps fall back to obj->ob_type if no
1407 __class__ exists? */
1408 PyErr_Clear();
1409 else {
1410 if (merge_class_dict(dict, itsclass) != 0)
1411 goto error;
1412 }
1413
1414 result = PyDict_Keys(dict);
Tim Peters7eea37e2001-09-04 22:08:56 +00001415 /* fall through */
Georg Brandle32b4222007-03-10 22:13:27 +00001416error:
1417 Py_XDECREF(itsclass);
1418 Py_XDECREF(dict);
1419 return result;
1420}
1421
1422/* Helper for PyObject_Dir: object introspection.
1423 This calls one of the above specialized versions if no __dir__ method
1424 exists. */
1425static PyObject *
1426_dir_object(PyObject *obj)
1427{
1428 PyObject * result = NULL;
1429 PyObject * dirfunc = PyObject_GetAttrString((PyObject*)obj->ob_type,
1430 "__dir__");
1431
1432 assert(obj);
1433 if (dirfunc == NULL) {
1434 /* use default implementation */
1435 PyErr_Clear();
1436 if (PyModule_Check(obj))
1437 result = _specialized_dir_module(obj);
1438 else if (PyType_Check(obj))
1439 result = _specialized_dir_type(obj);
1440 else
1441 result = _generic_dir(obj);
1442 }
1443 else {
1444 /* use __dir__ */
1445 result = PyObject_CallFunctionObjArgs(dirfunc, obj, NULL);
1446 Py_DECREF(dirfunc);
1447 if (result == NULL)
1448 return NULL;
1449
1450 /* result must be a list */
1451 /* XXX(gbrandl): could also check if all items are strings */
1452 if (!PyList_Check(result)) {
1453 PyErr_Format(PyExc_TypeError,
1454 "__dir__() must return a list, not %.200s",
Christian Heimes90aa7642007-12-19 02:45:37 +00001455 Py_TYPE(result)->tp_name);
Georg Brandle32b4222007-03-10 22:13:27 +00001456 Py_DECREF(result);
1457 result = NULL;
1458 }
1459 }
1460
1461 return result;
1462}
1463
1464/* Implementation of dir() -- if obj is NULL, returns the names in the current
1465 (local) scope. Otherwise, performs introspection of the object: returns a
1466 sorted list of attribute names (supposedly) accessible from the object
1467*/
1468PyObject *
1469PyObject_Dir(PyObject *obj)
1470{
1471 PyObject * result;
1472
1473 if (obj == NULL)
1474 /* no object -- introspect the locals */
1475 result = _dir_locals();
1476 else
1477 /* object -- introspect the object */
1478 result = _dir_object(obj);
1479
1480 assert(result == NULL || PyList_Check(result));
1481
1482 if (result != NULL && PyList_Sort(result) != 0) {
1483 /* sorting the list failed */
1484 Py_DECREF(result);
1485 result = NULL;
1486 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001487
Tim Peters7eea37e2001-09-04 22:08:56 +00001488 return result;
1489}
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001490
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001491/*
1492NoObject is usable as a non-NULL undefined value, used by the macro None.
1493There is (and should be!) no way to create other objects of this type,
Guido van Rossum3f5da241990-12-20 15:06:42 +00001494so there is exactly one (which is indestructible, by the way).
Guido van Rossumba21a492001-08-16 08:17:26 +00001495(XXX This type and the type of NotImplemented below should be unified.)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001496*/
1497
Guido van Rossum0c182a11992-03-27 17:26:13 +00001498/* ARGSUSED */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001499static PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001500none_repr(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001501{
Walter Dörwald1ab83302007-05-18 17:15:44 +00001502 return PyUnicode_FromString("None");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001503}
1504
Barry Warsaw9bf16442001-01-23 16:24:35 +00001505/* ARGUSED */
1506static void
Tim Peters803526b2002-07-07 05:13:56 +00001507none_dealloc(PyObject* ignore)
Barry Warsaw9bf16442001-01-23 16:24:35 +00001508{
1509 /* This should never get called, but we also don't want to SEGV if
1510 * we accidently decref None out of existance.
1511 */
Martin v. Löwis3f19b102002-08-07 16:21:51 +00001512 Py_FatalError("deallocating None");
Barry Warsaw9bf16442001-01-23 16:24:35 +00001513}
1514
1515
Guido van Rossumba21a492001-08-16 08:17:26 +00001516static PyTypeObject PyNone_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001517 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumba21a492001-08-16 08:17:26 +00001518 "NoneType",
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001519 0,
1520 0,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001521 none_dealloc, /*tp_dealloc*/ /*never called*/
Guido van Rossum7066dd71992-09-17 17:54:56 +00001522 0, /*tp_print*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001523 0, /*tp_getattr*/
1524 0, /*tp_setattr*/
1525 0, /*tp_compare*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001526 none_repr, /*tp_repr*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001527 0, /*tp_as_number*/
1528 0, /*tp_as_sequence*/
1529 0, /*tp_as_mapping*/
Guido van Rossum9bfef441993-03-29 10:43:31 +00001530 0, /*tp_hash */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001531};
1532
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001533PyObject _Py_NoneStruct = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001534 _PyObject_EXTRA_INIT
1535 1, &PyNone_Type
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001536};
1537
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001538/* NotImplemented is an object that can be used to signal that an
1539 operation is not implemented for the given type combination. */
1540
1541static PyObject *
1542NotImplemented_repr(PyObject *op)
1543{
Walter Dörwald1ab83302007-05-18 17:15:44 +00001544 return PyUnicode_FromString("NotImplemented");
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001545}
1546
1547static PyTypeObject PyNotImplemented_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001548 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumba21a492001-08-16 08:17:26 +00001549 "NotImplementedType",
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001550 0,
1551 0,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001552 none_dealloc, /*tp_dealloc*/ /*never called*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001553 0, /*tp_print*/
1554 0, /*tp_getattr*/
1555 0, /*tp_setattr*/
1556 0, /*tp_compare*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001557 NotImplemented_repr, /*tp_repr*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001558 0, /*tp_as_number*/
1559 0, /*tp_as_sequence*/
1560 0, /*tp_as_mapping*/
1561 0, /*tp_hash */
1562};
1563
1564PyObject _Py_NotImplementedStruct = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001565 _PyObject_EXTRA_INIT
1566 1, &PyNotImplemented_Type
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001567};
1568
Guido van Rossumba21a492001-08-16 08:17:26 +00001569void
1570_Py_ReadyTypes(void)
1571{
1572 if (PyType_Ready(&PyType_Type) < 0)
1573 Py_FatalError("Can't initialize 'type'");
1574
Fred Drake0a4dd392004-07-02 18:57:45 +00001575 if (PyType_Ready(&_PyWeakref_RefType) < 0)
1576 Py_FatalError("Can't initialize 'weakref'");
1577
Guido van Rossum77f6a652002-04-03 22:41:51 +00001578 if (PyType_Ready(&PyBool_Type) < 0)
1579 Py_FatalError("Can't initialize 'bool'");
1580
Christian Heimes9c4756e2008-05-26 13:22:05 +00001581 if (PyType_Ready(&PyByteArray_Type) < 0)
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001582 Py_FatalError("Can't initialize 'bytes'");
1583
Christian Heimes72b710a2008-05-26 13:28:38 +00001584 if (PyType_Ready(&PyBytes_Type) < 0)
Guido van Rossumcacfc072002-05-24 19:01:59 +00001585 Py_FatalError("Can't initialize 'str'");
1586
Guido van Rossumba21a492001-08-16 08:17:26 +00001587 if (PyType_Ready(&PyList_Type) < 0)
1588 Py_FatalError("Can't initialize 'list'");
1589
1590 if (PyType_Ready(&PyNone_Type) < 0)
1591 Py_FatalError("Can't initialize type(None)");
1592
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001593 if (PyType_Ready(Py_Ellipsis->ob_type) < 0)
1594 Py_FatalError("Can't initialize type(Ellipsis)");
1595
Guido van Rossumba21a492001-08-16 08:17:26 +00001596 if (PyType_Ready(&PyNotImplemented_Type) < 0)
1597 Py_FatalError("Can't initialize type(NotImplemented)");
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001598
1599 if (PyType_Ready(&PyCode_Type) < 0)
1600 Py_FatalError("Can't initialize 'code'");
Guido van Rossum826d8972007-10-30 18:34:07 +00001601
1602 if (PyType_Ready(&PyStdPrinter_Type) < 0)
1603 Py_FatalError("Can't initialize StdPrinter");
Guido van Rossumba21a492001-08-16 08:17:26 +00001604}
1605
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001606
Guido van Rossum84a90321996-05-22 16:34:47 +00001607#ifdef Py_TRACE_REFS
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001608
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001609void
Fred Drake100814d2000-07-09 15:48:49 +00001610_Py_NewReference(PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001611{
Tim Peters34592512002-07-11 06:23:50 +00001612 _Py_INC_REFTOTAL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001613 op->ob_refcnt = 1;
Tim Peters7571a0f2003-03-23 17:52:28 +00001614 _Py_AddToAllObjects(op, 1);
Tim Peters34592512002-07-11 06:23:50 +00001615 _Py_INC_TPALLOCS(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001616}
1617
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001618void
Fred Drake100814d2000-07-09 15:48:49 +00001619_Py_ForgetReference(register PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001620{
Guido van Rossumbffd6832000-01-20 22:32:56 +00001621#ifdef SLOW_UNREF_CHECK
Guido van Rossum4c08d552000-03-10 22:55:18 +00001622 register PyObject *p;
Guido van Rossumbffd6832000-01-20 22:32:56 +00001623#endif
Guido van Rossumd7047b31995-01-02 19:07:15 +00001624 if (op->ob_refcnt < 0)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001625 Py_FatalError("UNREF negative refcnt");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001626 if (op == &refchain ||
Christian Heimesc8967002007-11-30 10:18:26 +00001627 op->_ob_prev->_ob_next != op || op->_ob_next->_ob_prev != op) {
1628 fprintf(stderr, "* ob\n");
1629 _PyObject_Dump(op);
1630 fprintf(stderr, "* op->_ob_prev->_ob_next\n");
1631 _PyObject_Dump(op->_ob_prev->_ob_next);
1632 fprintf(stderr, "* op->_ob_next->_ob_prev\n");
1633 _PyObject_Dump(op->_ob_next->_ob_prev);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001634 Py_FatalError("UNREF invalid object");
Christian Heimesc8967002007-11-30 10:18:26 +00001635 }
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001636#ifdef SLOW_UNREF_CHECK
Guido van Rossum3f5da241990-12-20 15:06:42 +00001637 for (p = refchain._ob_next; p != &refchain; p = p->_ob_next) {
1638 if (p == op)
1639 break;
1640 }
Guido van Rossumd7047b31995-01-02 19:07:15 +00001641 if (p == &refchain) /* Not found */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001642 Py_FatalError("UNREF unknown object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001643#endif
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001644 op->_ob_next->_ob_prev = op->_ob_prev;
1645 op->_ob_prev->_ob_next = op->_ob_next;
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001646 op->_ob_next = op->_ob_prev = NULL;
Tim Peters34592512002-07-11 06:23:50 +00001647 _Py_INC_TPFREES(op);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001648}
1649
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001650void
Fred Drake100814d2000-07-09 15:48:49 +00001651_Py_Dealloc(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001652{
Christian Heimes90aa7642007-12-19 02:45:37 +00001653 destructor dealloc = Py_TYPE(op)->tp_dealloc;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001654 _Py_ForgetReference(op);
Guido van Rossum9776adf1994-09-07 14:36:45 +00001655 (*dealloc)(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001656}
1657
Tim Peters269b2a62003-04-17 19:52:29 +00001658/* Print all live objects. Because PyObject_Print is called, the
1659 * interpreter must be in a healthy state.
1660 */
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001661void
Fred Drake100814d2000-07-09 15:48:49 +00001662_Py_PrintReferences(FILE *fp)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001663{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001664 PyObject *op;
Guido van Rossume09fb551997-08-05 02:04:34 +00001665 fprintf(fp, "Remaining objects:\n");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001666 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next) {
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001667 fprintf(fp, "%p [%" PY_FORMAT_SIZE_T "d] ", op, op->ob_refcnt);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001668 if (PyObject_Print(op, fp, 0) != 0)
1669 PyErr_Clear();
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001670 putc('\n', fp);
1671 }
1672}
1673
Tim Peters269b2a62003-04-17 19:52:29 +00001674/* Print the addresses of all live objects. Unlike _Py_PrintReferences, this
1675 * doesn't make any calls to the Python C API, so is always safe to call.
1676 */
1677void
1678_Py_PrintReferenceAddresses(FILE *fp)
1679{
1680 PyObject *op;
1681 fprintf(fp, "Remaining object addresses:\n");
1682 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001683 fprintf(fp, "%p [%" PY_FORMAT_SIZE_T "d] %s\n", op,
Christian Heimes90aa7642007-12-19 02:45:37 +00001684 op->ob_refcnt, Py_TYPE(op)->tp_name);
Tim Peters269b2a62003-04-17 19:52:29 +00001685}
1686
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001687PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001688_Py_GetObjects(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001689{
1690 int i, n;
1691 PyObject *t = NULL;
1692 PyObject *res, *op;
1693
1694 if (!PyArg_ParseTuple(args, "i|O", &n, &t))
1695 return NULL;
1696 op = refchain._ob_next;
1697 res = PyList_New(0);
1698 if (res == NULL)
1699 return NULL;
1700 for (i = 0; (n == 0 || i < n) && op != &refchain; i++) {
1701 while (op == self || op == args || op == res || op == t ||
Christian Heimes90aa7642007-12-19 02:45:37 +00001702 (t != NULL && Py_TYPE(op) != (PyTypeObject *) t)) {
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001703 op = op->_ob_next;
1704 if (op == &refchain)
1705 return res;
1706 }
1707 if (PyList_Append(res, op) < 0) {
1708 Py_DECREF(res);
1709 return NULL;
1710 }
1711 op = op->_ob_next;
1712 }
1713 return res;
1714}
1715
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001716#endif
Guido van Rossum97ead3f1996-01-12 01:24:09 +00001717
1718
1719/* Hack to force loading of cobject.o */
Guido van Rossumda9c2711996-12-05 21:58:58 +00001720PyTypeObject *_Py_cobject_hack = &PyCObject_Type;
Guido van Rossum84a90321996-05-22 16:34:47 +00001721
1722
1723/* Hack to force loading of abstract.o */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001724Py_ssize_t (*_Py_abstract_hack)(PyObject *) = PyObject_Size;
Guido van Rossume09fb551997-08-05 02:04:34 +00001725
1726
Andrew M. Kuchling1582a3a2000-08-16 12:27:23 +00001727/* Python's malloc wrappers (see pymem.h) */
Guido van Rossume09fb551997-08-05 02:04:34 +00001728
Thomas Wouters334fb892000-07-25 12:56:38 +00001729void *
Fred Drake100814d2000-07-09 15:48:49 +00001730PyMem_Malloc(size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001731{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001732 return PyMem_MALLOC(nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001733}
1734
Thomas Wouters334fb892000-07-25 12:56:38 +00001735void *
1736PyMem_Realloc(void *p, size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001737{
Tim Petersaf3e8de2002-04-12 07:22:56 +00001738 return PyMem_REALLOC(p, nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001739}
1740
1741void
Thomas Wouters334fb892000-07-25 12:56:38 +00001742PyMem_Free(void *p)
Guido van Rossume09fb551997-08-05 02:04:34 +00001743{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001744 PyMem_FREE(p);
1745}
1746
1747
Guido van Rossum86610361998-04-10 22:32:46 +00001748/* These methods are used to control infinite recursion in repr, str, print,
1749 etc. Container objects that may recursively contain themselves,
1750 e.g. builtin dictionaries and lists, should used Py_ReprEnter() and
1751 Py_ReprLeave() to avoid infinite recursion.
1752
1753 Py_ReprEnter() returns 0 the first time it is called for a particular
1754 object and 1 every time thereafter. It returns -1 if an exception
1755 occurred. Py_ReprLeave() has no return value.
1756
1757 See dictobject.c and listobject.c for examples of use.
1758*/
1759
1760#define KEY "Py_Repr"
1761
1762int
Fred Drake100814d2000-07-09 15:48:49 +00001763Py_ReprEnter(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001764{
1765 PyObject *dict;
1766 PyObject *list;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001767 Py_ssize_t i;
Guido van Rossum86610361998-04-10 22:32:46 +00001768
1769 dict = PyThreadState_GetDict();
1770 if (dict == NULL)
Guido van Rossum0fc8f002003-04-15 15:12:39 +00001771 return 0;
Guido van Rossum86610361998-04-10 22:32:46 +00001772 list = PyDict_GetItemString(dict, KEY);
1773 if (list == NULL) {
1774 list = PyList_New(0);
1775 if (list == NULL)
1776 return -1;
1777 if (PyDict_SetItemString(dict, KEY, list) < 0)
1778 return -1;
1779 Py_DECREF(list);
1780 }
1781 i = PyList_GET_SIZE(list);
1782 while (--i >= 0) {
1783 if (PyList_GET_ITEM(list, i) == obj)
1784 return 1;
1785 }
1786 PyList_Append(list, obj);
1787 return 0;
1788}
1789
1790void
Fred Drake100814d2000-07-09 15:48:49 +00001791Py_ReprLeave(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001792{
1793 PyObject *dict;
1794 PyObject *list;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001795 Py_ssize_t i;
Guido van Rossum86610361998-04-10 22:32:46 +00001796
1797 dict = PyThreadState_GetDict();
Guido van Rossumeb909461998-04-11 15:17:34 +00001798 if (dict == NULL)
1799 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001800 list = PyDict_GetItemString(dict, KEY);
Guido van Rossumeb909461998-04-11 15:17:34 +00001801 if (list == NULL || !PyList_Check(list))
1802 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001803 i = PyList_GET_SIZE(list);
1804 /* Count backwards because we always expect obj to be list[-1] */
1805 while (--i >= 0) {
1806 if (PyList_GET_ITEM(list, i) == obj) {
1807 PyList_SetSlice(list, i, i + 1, NULL);
1808 break;
1809 }
1810 }
1811}
Guido van Rossumd724b232000-03-13 16:01:29 +00001812
Tim Peters803526b2002-07-07 05:13:56 +00001813/* Trashcan support. */
Guido van Rossumd724b232000-03-13 16:01:29 +00001814
Tim Peters803526b2002-07-07 05:13:56 +00001815/* Current call-stack depth of tp_dealloc calls. */
Guido van Rossumd724b232000-03-13 16:01:29 +00001816int _PyTrash_delete_nesting = 0;
Guido van Rossume92e6102000-04-24 15:40:53 +00001817
Tim Peters803526b2002-07-07 05:13:56 +00001818/* List of objects that still need to be cleaned up, singly linked via their
1819 * gc headers' gc_prev pointers.
1820 */
1821PyObject *_PyTrash_delete_later = NULL;
Guido van Rossumd724b232000-03-13 16:01:29 +00001822
Tim Peters803526b2002-07-07 05:13:56 +00001823/* Add op to the _PyTrash_delete_later list. Called when the current
1824 * call-stack depth gets large. op must be a currently untracked gc'ed
1825 * object, with refcount 0. Py_DECREF must already have been called on it.
1826 */
Guido van Rossumd724b232000-03-13 16:01:29 +00001827void
Fred Drake100814d2000-07-09 15:48:49 +00001828_PyTrash_deposit_object(PyObject *op)
Guido van Rossumd724b232000-03-13 16:01:29 +00001829{
Tim Peters803526b2002-07-07 05:13:56 +00001830 assert(PyObject_IS_GC(op));
1831 assert(_Py_AS_GC(op)->gc.gc_refs == _PyGC_REFS_UNTRACKED);
1832 assert(op->ob_refcnt == 0);
Neil Schemenauerf589c052002-03-29 03:05:54 +00001833 _Py_AS_GC(op)->gc.gc_prev = (PyGC_Head *)_PyTrash_delete_later;
Guido van Rossume92e6102000-04-24 15:40:53 +00001834 _PyTrash_delete_later = op;
Guido van Rossumd724b232000-03-13 16:01:29 +00001835}
1836
Tim Peters803526b2002-07-07 05:13:56 +00001837/* Dealloccate all the objects in the _PyTrash_delete_later list. Called when
1838 * the call-stack unwinds again.
1839 */
Guido van Rossumd724b232000-03-13 16:01:29 +00001840void
Fred Drake100814d2000-07-09 15:48:49 +00001841_PyTrash_destroy_chain(void)
Guido van Rossumd724b232000-03-13 16:01:29 +00001842{
1843 while (_PyTrash_delete_later) {
Tim Peters803526b2002-07-07 05:13:56 +00001844 PyObject *op = _PyTrash_delete_later;
Christian Heimes90aa7642007-12-19 02:45:37 +00001845 destructor dealloc = Py_TYPE(op)->tp_dealloc;
Neil Schemenauerf589c052002-03-29 03:05:54 +00001846
Neil Schemenauerf589c052002-03-29 03:05:54 +00001847 _PyTrash_delete_later =
Tim Peters803526b2002-07-07 05:13:56 +00001848 (PyObject*) _Py_AS_GC(op)->gc.gc_prev;
Neil Schemenauerf589c052002-03-29 03:05:54 +00001849
Tim Peters803526b2002-07-07 05:13:56 +00001850 /* Call the deallocator directly. This used to try to
1851 * fool Py_DECREF into calling it indirectly, but
1852 * Py_DECREF was already called on this object, and in
1853 * assorted non-release builds calling Py_DECREF again ends
1854 * up distorting allocation statistics.
1855 */
1856 assert(op->ob_refcnt == 0);
Guido van Rossumd724b232000-03-13 16:01:29 +00001857 ++_PyTrash_delete_nesting;
Tim Peters803526b2002-07-07 05:13:56 +00001858 (*dealloc)(op);
Guido van Rossumd724b232000-03-13 16:01:29 +00001859 --_PyTrash_delete_nesting;
1860 }
1861}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001862
1863#ifdef __cplusplus
1864}
1865#endif