blob: 04d5f488be69b84b3ee56f97444327428daa9dd8 [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) {
274 fprintf(fp, "<nil>");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000275 }
Guido van Rossum90933611991-06-07 16:10:43 +0000276 else {
277 if (op->ob_refcnt <= 0)
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000278 /* XXX(twouters) cast refcount to long until %zd is
279 universally available */
280 fprintf(fp, "<refcnt %ld at %p>",
281 (long)op->ob_refcnt, op);
Guido van Rossum04dbf3b2007-08-07 19:51:00 +0000282 else {
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000283 PyObject *s;
284 if (flags & Py_PRINT_RAW)
285 s = PyObject_Str(op);
286 else
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000287 s = PyObject_Repr(op);
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000288 if (s == NULL)
289 ret = -1;
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000290 else if (PyString_Check(s)) {
291 fwrite(PyString_AS_STRING(s), 1,
292 PyString_GET_SIZE(s), fp);
293 }
294 else if (PyUnicode_Check(s)) {
295 PyObject *t;
296 t = _PyUnicode_AsDefaultEncodedString(s, NULL);
297 if (t == NULL)
298 ret = 0;
299 else {
300 fwrite(PyString_AS_STRING(t), 1,
301 PyString_GET_SIZE(t), fp);
302 }
303 }
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000304 else {
Guido van Rossum6ca130d2007-08-09 20:47:59 +0000305 PyErr_Format(PyExc_TypeError,
306 "str() or repr() returned '%.100s'",
307 s->ob_type->tp_name);
308 ret = -1;
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000309 }
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000310 Py_XDECREF(s);
Guido van Rossum2e8f6141992-09-03 20:32:55 +0000311 }
Guido van Rossum90933611991-06-07 16:10:43 +0000312 }
Guido van Rossum278ef591991-07-27 21:40:24 +0000313 if (ret == 0) {
314 if (ferror(fp)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000315 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossum278ef591991-07-27 21:40:24 +0000316 clearerr(fp);
317 ret = -1;
318 }
319 }
320 return ret;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000321}
322
Neal Norwitz1a997502003-01-13 20:13:12 +0000323int
324PyObject_Print(PyObject *op, FILE *fp, int flags)
325{
326 return internal_print(op, fp, flags, 0);
327}
328
Guido van Rossum38938152006-08-21 23:36:26 +0000329/* For debugging convenience. Set a breakpoint here and call it from your DLL */
330void
Thomas Woutersb2137042007-02-01 18:02:27 +0000331_Py_BreakPoint(void)
Guido van Rossum38938152006-08-21 23:36:26 +0000332{
333}
334
Neal Norwitz1a997502003-01-13 20:13:12 +0000335
Barry Warsaw9bf16442001-01-23 16:24:35 +0000336/* For debugging convenience. See Misc/gdbinit for some useful gdb hooks */
Guido van Rossum38938152006-08-21 23:36:26 +0000337void
338_PyObject_Dump(PyObject* op)
Barry Warsaw9bf16442001-01-23 16:24:35 +0000339{
Barry Warsaweefb1072001-02-22 22:39:18 +0000340 if (op == NULL)
341 fprintf(stderr, "NULL\n");
342 else {
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000343 fprintf(stderr, "object : ");
Barry Warsaweefb1072001-02-22 22:39:18 +0000344 (void)PyObject_Print(op, stderr, 0);
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000345 /* XXX(twouters) cast refcount to long until %zd is
346 universally available */
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000347 fprintf(stderr, "\n"
348 "type : %s\n"
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000349 "refcount: %ld\n"
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000350 "address : %p\n",
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000351 Py_Type(op)==NULL ? "NULL" : Py_Type(op)->tp_name,
Thomas Wouters8b87a0b2006-03-01 05:41:20 +0000352 (long)op->ob_refcnt,
Guido van Rossum5f5512d2001-09-14 15:50:08 +0000353 op);
Barry Warsaweefb1072001-02-22 22:39:18 +0000354 }
Barry Warsaw9bf16442001-01-23 16:24:35 +0000355}
Barry Warsaw903138f2001-01-23 16:33:18 +0000356
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000357PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000358PyObject_Repr(PyObject *v)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000359{
Walter Dörwald1ab83302007-05-18 17:15:44 +0000360 PyObject *ress, *resu;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000361 if (PyErr_CheckSignals())
Guido van Rossum90933611991-06-07 16:10:43 +0000362 return NULL;
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000363#ifdef USE_STACKCHECK
364 if (PyOS_CheckStack()) {
Fred Drake661ea262000-10-24 19:57:45 +0000365 PyErr_SetString(PyExc_MemoryError, "stack overflow");
Guido van Rossum9b00dfa1998-04-28 16:06:54 +0000366 return NULL;
367 }
368#endif
Guido van Rossum90933611991-06-07 16:10:43 +0000369 if (v == NULL)
Walter Dörwald1ab83302007-05-18 17:15:44 +0000370 return PyUnicode_FromString("<NULL>");
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000371 else if (Py_Type(v)->tp_repr == NULL)
Walter Dörwald1ab83302007-05-18 17:15:44 +0000372 return PyUnicode_FromFormat("<%s object at %p>", v->ob_type->tp_name, v);
Guido van Rossum4c08d552000-03-10 22:55:18 +0000373 else {
Walter Dörwald1ab83302007-05-18 17:15:44 +0000374 ress = (*v->ob_type->tp_repr)(v);
375 if (!ress)
Guido van Rossum4c08d552000-03-10 22:55:18 +0000376 return NULL;
Walter Dörwald1ab83302007-05-18 17:15:44 +0000377 if (PyUnicode_Check(ress))
378 return ress;
379 if (!PyString_Check(ress)) {
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)",
Walter Dörwald1ab83302007-05-18 17:15:44 +0000382 ress->ob_type->tp_name);
383 Py_DECREF(ress);
Guido van Rossum4c08d552000-03-10 22:55:18 +0000384 return NULL;
385 }
Walter Dörwald1ab83302007-05-18 17:15:44 +0000386 resu = PyUnicode_FromObject(ress);
387 Py_DECREF(ress);
388 return resu;
Guido van Rossum4c08d552000-03-10 22:55:18 +0000389 }
Guido van Rossum85a5fbb1990-10-14 12:07:46 +0000390}
391
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000392PyObject *
Walter Dörwald1ab83302007-05-18 17:15:44 +0000393PyObject_ReprStr8(PyObject *v)
394{
395 PyObject *resu = PyObject_Repr(v);
396 if (resu) {
397 PyObject *resb = PyUnicode_AsEncodedString(resu, NULL, NULL);
398 Py_DECREF(resu);
399 if (resb) {
400 PyObject *ress = PyString_FromStringAndSize(
401 PyBytes_AS_STRING(resb),
402 PyBytes_GET_SIZE(resb)
403 );
404 Py_DECREF(resb);
405 return ress;
406 }
407 }
408 return NULL;
409}
410
411PyObject *
Neil Schemenauercf52c072005-08-12 17:34:58 +0000412_PyObject_Str(PyObject *v)
Guido van Rossumc6004111993-11-05 10:22:19 +0000413{
Guido van Rossum4c08d552000-03-10 22:55:18 +0000414 PyObject *res;
Guido van Rossumc6004111993-11-05 10:22:19 +0000415 if (v == NULL)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000416 return PyString_FromString("<NULL>");
Tim Peters5a49ade2001-09-11 01:41:59 +0000417 if (PyString_CheckExact(v)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000418 Py_INCREF(v);
Guido van Rossumc6004111993-11-05 10:22:19 +0000419 return v;
420 }
Neil Schemenauercf52c072005-08-12 17:34:58 +0000421 if (PyUnicode_CheckExact(v)) {
422 Py_INCREF(v);
423 return v;
424 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000425 if (Py_Type(v)->tp_str == NULL)
Guido van Rossum4f288ab2001-05-01 16:53:37 +0000426 return PyObject_Repr(v);
427
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000428 res = (*Py_Type(v)->tp_str)(v);
Guido van Rossum4c08d552000-03-10 22:55:18 +0000429 if (res == NULL)
430 return NULL;
Guido van Rossum55b4a7b2007-07-11 09:28:11 +0000431 if (!(PyString_Check(res) || PyUnicode_Check(res))) {
Neil Schemenauercf52c072005-08-12 17:34:58 +0000432 PyErr_Format(PyExc_TypeError,
433 "__str__ returned non-string (type %.200s)",
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000434 Py_Type(res)->tp_name);
Neil Schemenauercf52c072005-08-12 17:34:58 +0000435 Py_DECREF(res);
436 return NULL;
437 }
438 return res;
439}
440
441PyObject *
442PyObject_Str(PyObject *v)
443{
444 PyObject *res = _PyObject_Str(v);
445 if (res == NULL)
446 return NULL;
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000447 if (PyUnicode_Check(res)) {
448 PyObject* str;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000449 str = _PyUnicode_AsDefaultEncodedString(res, NULL);
450 Py_XINCREF(str);
Marc-André Lemburg891bc652000-07-03 09:57:53 +0000451 Py_DECREF(res);
452 if (str)
453 res = str;
454 else
455 return NULL;
456 }
Neil Schemenauercf52c072005-08-12 17:34:58 +0000457 assert(PyString_Check(res));
Guido van Rossum4c08d552000-03-10 22:55:18 +0000458 return res;
Guido van Rossumc6004111993-11-05 10:22:19 +0000459}
460
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000461PyObject *
462PyObject_Unicode(PyObject *v)
463{
464 PyObject *res;
Brett Cannonc3647ac2005-04-26 03:45:26 +0000465 PyObject *func;
Neal Norwitz75801462006-03-14 06:02:16 +0000466 PyObject *str;
Brett Cannonc3647ac2005-04-26 03:45:26 +0000467 static PyObject *unicodestr;
Tim Peters803526b2002-07-07 05:13:56 +0000468
Walter Dörwaldb03ccc02007-05-11 17:25:52 +0000469 if (v == NULL)
470 return PyUnicode_FromString("<NULL>");
471 else if (PyUnicode_CheckExact(v)) {
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000472 Py_INCREF(v);
473 return v;
474 }
Brett Cannonc3647ac2005-04-26 03:45:26 +0000475 /* XXX As soon as we have a tp_unicode slot, we should
476 check this before trying the __unicode__
477 method. */
478 if (unicodestr == NULL) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000479 unicodestr= PyUnicode_InternFromString("__unicode__");
Brett Cannonc3647ac2005-04-26 03:45:26 +0000480 if (unicodestr == NULL)
481 return NULL;
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000482 }
Brett Cannonc3647ac2005-04-26 03:45:26 +0000483 func = PyObject_GetAttr(v, unicodestr);
484 if (func != NULL) {
485 res = PyEval_CallObject(func, (PyObject *)NULL);
486 Py_DECREF(func);
487 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000488 else {
Brett Cannonc3647ac2005-04-26 03:45:26 +0000489 PyErr_Clear();
Guido van Rossum55b4a7b2007-07-11 09:28:11 +0000490 if (PyUnicode_Check(v) &&
491 v->ob_type->tp_str == PyUnicode_Type.tp_str) {
492 /* For a Unicode subtype that's didn't overwrite
493 __unicode__ or __str__,
Brett Cannonc3647ac2005-04-26 03:45:26 +0000494 return a true Unicode object with the same data. */
495 return PyUnicode_FromUnicode(PyUnicode_AS_UNICODE(v),
496 PyUnicode_GET_SIZE(v));
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000497 }
Brett Cannonc3647ac2005-04-26 03:45:26 +0000498 if (PyString_CheckExact(v)) {
499 Py_INCREF(v);
500 res = v;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000501 }
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000502 else {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000503 if (Py_Type(v)->tp_str != NULL)
504 res = (*Py_Type(v)->tp_str)(v);
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000505 else
506 res = PyObject_Repr(v);
507 }
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000508 }
509 if (res == NULL)
510 return NULL;
511 if (!PyUnicode_Check(res)) {
Guido van Rossumb8c65bc2001-10-19 02:01:31 +0000512 str = PyUnicode_FromEncodedObject(res, NULL, "strict");
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000513 Py_DECREF(res);
Neal Norwitz75801462006-03-14 06:02:16 +0000514 res = str;
Guido van Rossuma3af41d2001-01-18 22:07:06 +0000515 }
516 return res;
517}
518
519
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000520/* The new comparison philosophy is: we completely separate three-way
521 comparison from rich comparison. That is, PyObject_Compare() and
522 PyObject_Cmp() *just* use the tp_compare slot. And PyObject_RichCompare()
523 and PyObject_RichCompareBool() *just* use the tp_richcompare slot.
524
525 See (*) below for practical amendments.
526
527 IOW, only cmp() uses tp_compare; the comparison operators (==, !=, <=, <,
528 >=, >) only use tp_richcompare. Note that list.sort() only uses <.
529
530 (And yes, eventually we'll rip out cmp() and tp_compare.)
531
532 The calling conventions are different: tp_compare only gets called with two
533 objects of the appropriate type; tp_richcompare gets called with a first
534 argument of the appropriate type and a second object of an arbitrary type.
535 We never do any kind of coercion.
536
537 The return conventions are also different.
538
539 The tp_compare slot should return a C int, as follows:
540
541 -1 if a < b or if an exception occurred
542 0 if a == b
543 +1 if a > b
544
545 No other return values are allowed. PyObject_Compare() has the same
546 calling convention.
547
548 The tp_richcompare slot should return an object, as follows:
549
550 NULL if an exception occurred
551 NotImplemented if the requested comparison is not implemented
552 any other false value if the requested comparison is false
553 any other true value if the requested comparison is true
554
555 The PyObject_RichCompare[Bool]() wrappers raise TypeError when they get
556 NotImplemented.
557
558 (*) Practical amendments:
559
560 - If rich comparison returns NotImplemented, == and != are decided by
561 comparing the object pointer (i.e. falling back to the base object
562 implementation).
563
564 - If three-way comparison is not implemented, it falls back on rich
565 comparison (but not the other way around!).
566
Guido van Rossuma4073002002-05-31 20:03:54 +0000567*/
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000568
569/* Forward */
570static PyObject *do_richcompare(PyObject *v, PyObject *w, int op);
571
572/* Perform a three-way comparison, raising TypeError if three-way comparison
573 is not supported. */
Guido van Rossuma4073002002-05-31 20:03:54 +0000574static int
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000575do_compare(PyObject *v, PyObject *w)
Guido van Rossuma4073002002-05-31 20:03:54 +0000576{
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000577 cmpfunc f;
578 int ok;
579
580 if (v->ob_type == w->ob_type &&
581 (f = v->ob_type->tp_compare) != NULL) {
582 return (*f)(v, w);
Guido van Rossuma4073002002-05-31 20:03:54 +0000583 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000584
585 /* Now try three-way compare before giving up. This is intentionally
586 elaborate; if you have a it will raise TypeError if it detects two
587 objects that aren't ordered with respect to each other. */
588 ok = PyObject_RichCompareBool(v, w, Py_LT);
589 if (ok < 0)
590 return -1; /* Error */
591 if (ok)
592 return -1; /* Less than */
593 ok = PyObject_RichCompareBool(v, w, Py_GT);
594 if (ok < 0)
595 return -1; /* Error */
596 if (ok)
597 return 1; /* Greater than */
598 ok = PyObject_RichCompareBool(v, w, Py_EQ);
599 if (ok < 0)
600 return -1; /* Error */
601 if (ok)
602 return 0; /* Equal */
603
604 /* Give up */
605 PyErr_Format(PyExc_TypeError,
Neal Norwitz3bd844e2006-08-29 04:39:12 +0000606 "unorderable types: '%.100s' != '%.100s'",
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000607 v->ob_type->tp_name,
608 w->ob_type->tp_name);
609 return -1;
Guido van Rossuma4073002002-05-31 20:03:54 +0000610}
611
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000612/* Perform a three-way comparison. This wraps do_compare() with a check for
613 NULL arguments and a recursion check. */
614int
615PyObject_Compare(PyObject *v, PyObject *w)
616{
617 int res;
Guido van Rossuma4073002002-05-31 20:03:54 +0000618
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000619 if (v == NULL || w == NULL) {
620 if (!PyErr_Occurred())
621 PyErr_BadInternalCall();
622 return -1;
623 }
624 if (Py_EnterRecursiveCall(" in cmp"))
625 return -1;
626 res = do_compare(v, w);
627 Py_LeaveRecursiveCall();
628 return res < 0 ? -1 : res;
629}
Guido van Rossumd1f06b92001-01-24 22:14:43 +0000630
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000631/* Map rich comparison operators to their swapped version, e.g. LT <--> GT */
Brett Cannona5ca2e72004-09-25 01:37:24 +0000632int _Py_SwappedOp[] = {Py_GT, Py_GE, Py_EQ, Py_NE, Py_LT, Py_LE};
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +0000633
Guido van Rossum9a4e95c2006-12-19 21:35:46 +0000634static char *opstrings[] = {"<", "<=", "==", "!=", ">", ">="};
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000635
636/* Perform a rich comparison, raising TypeError when the requested comparison
637 operator is not supported. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000638static PyObject *
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000639do_richcompare(PyObject *v, PyObject *w, int op)
Guido van Rossume797ec12001-01-17 15:24:28 +0000640{
641 richcmpfunc f;
642 PyObject *res;
643
Guido van Rossum2ed6bf82001-09-27 20:30:07 +0000644 if (v->ob_type != w->ob_type &&
645 PyType_IsSubtype(w->ob_type, v->ob_type) &&
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000646 (f = w->ob_type->tp_richcompare) != NULL) {
Tim Petersf4aca752004-09-23 02:39:37 +0000647 res = (*f)(w, v, _Py_SwappedOp[op]);
Guido van Rossum2ed6bf82001-09-27 20:30:07 +0000648 if (res != Py_NotImplemented)
649 return res;
650 Py_DECREF(res);
651 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000652 if ((f = v->ob_type->tp_richcompare) != NULL) {
Guido van Rossume797ec12001-01-17 15:24:28 +0000653 res = (*f)(v, w, op);
654 if (res != Py_NotImplemented)
655 return res;
656 Py_DECREF(res);
657 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000658 if ((f = w->ob_type->tp_richcompare) != NULL) {
659 res = (*f)(w, v, _Py_SwappedOp[op]);
660 if (res != Py_NotImplemented)
661 return res;
662 Py_DECREF(res);
Guido van Rossume797ec12001-01-17 15:24:28 +0000663 }
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000664 /* If neither object implements it, provide a sensible default
665 for == and !=, but raise an exception for ordering. */
666 switch (op) {
667 case Py_EQ:
668 res = (v == w) ? Py_True : Py_False;
669 break;
670 case Py_NE:
671 res = (v != w) ? Py_True : Py_False;
672 break;
673 default:
Guido van Rossum9a4e95c2006-12-19 21:35:46 +0000674 /* XXX Special-case None so it doesn't show as NoneType() */
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000675 PyErr_Format(PyExc_TypeError,
676 "unorderable types: %.100s() %s %.100s()",
677 v->ob_type->tp_name,
678 opstrings[op],
679 w->ob_type->tp_name);
680 return NULL;
681 }
Guido van Rossume797ec12001-01-17 15:24:28 +0000682 Py_INCREF(res);
683 return res;
684}
685
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000686/* Perform a rich comparison with object result. This wraps do_richcompare()
687 with a check for NULL arguments and a recursion check. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000688
Guido van Rossume797ec12001-01-17 15:24:28 +0000689PyObject *
690PyObject_RichCompare(PyObject *v, PyObject *w, int op)
691{
692 PyObject *res;
693
694 assert(Py_LT <= op && op <= Py_GE);
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000695 if (v == NULL || w == NULL) {
696 if (!PyErr_Occurred())
697 PyErr_BadInternalCall();
698 return NULL;
699 }
Armin Rigo2b3eb402003-10-28 12:05:48 +0000700 if (Py_EnterRecursiveCall(" in cmp"))
701 return NULL;
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000702 res = do_richcompare(v, w, op);
Armin Rigo2b3eb402003-10-28 12:05:48 +0000703 Py_LeaveRecursiveCall();
Guido van Rossume797ec12001-01-17 15:24:28 +0000704 return res;
705}
706
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000707/* Perform a rich comparison with integer result. This wraps
708 PyObject_RichCompare(), returning -1 for error, 0 for false, 1 for true. */
Guido van Rossume797ec12001-01-17 15:24:28 +0000709int
710PyObject_RichCompareBool(PyObject *v, PyObject *w, int op)
711{
Raymond Hettinger93d44812004-03-21 17:01:44 +0000712 PyObject *res;
Guido van Rossume797ec12001-01-17 15:24:28 +0000713 int ok;
714
Raymond Hettinger93d44812004-03-21 17:01:44 +0000715 res = PyObject_RichCompare(v, w, op);
Guido van Rossume797ec12001-01-17 15:24:28 +0000716 if (res == NULL)
717 return -1;
Guido van Rossum81912d42002-08-24 05:33:28 +0000718 if (PyBool_Check(res))
719 ok = (res == Py_True);
720 else
721 ok = PyObject_IsTrue(res);
Guido van Rossume797ec12001-01-17 15:24:28 +0000722 Py_DECREF(res);
723 return ok;
724}
Fred Drake13634cf2000-06-29 19:17:04 +0000725
Guido van Rossum47b9ff62006-08-24 00:41:19 +0000726/* Turn the result of a three-way comparison into the result expected by a
727 rich comparison. */
728PyObject *
729Py_CmpToRich(int op, int cmp)
730{
731 PyObject *res;
732 int ok;
733
734 if (PyErr_Occurred())
735 return NULL;
736 switch (op) {
737 case Py_LT:
738 ok = cmp < 0;
739 break;
740 case Py_LE:
741 ok = cmp <= 0;
742 break;
743 case Py_EQ:
744 ok = cmp == 0;
745 break;
746 case Py_NE:
747 ok = cmp != 0;
748 break;
749 case Py_GT:
750 ok = cmp > 0;
751 break;
752 case Py_GE:
753 ok = cmp >= 0;
754 break;
755 default:
756 PyErr_BadArgument();
757 return NULL;
758 }
759 res = ok ? Py_True : Py_False;
760 Py_INCREF(res);
761 return res;
762}
763
Fred Drake13634cf2000-06-29 19:17:04 +0000764/* Set of hash utility functions to help maintaining the invariant that
Raymond Hettinger8183fa42004-03-21 17:35:06 +0000765 if a==b then hash(a)==hash(b)
Fred Drake13634cf2000-06-29 19:17:04 +0000766
767 All the utility functions (_Py_Hash*()) return "-1" to signify an error.
768*/
769
770long
Fred Drake100814d2000-07-09 15:48:49 +0000771_Py_HashDouble(double v)
Fred Drake13634cf2000-06-29 19:17:04 +0000772{
Tim Peters39dce292000-08-15 03:34:48 +0000773 double intpart, fractpart;
774 int expo;
775 long hipart;
776 long x; /* the final hash value */
777 /* This is designed so that Python numbers of different types
778 * that compare equal hash to the same value; otherwise comparisons
779 * of mapping keys will turn out weird.
780 */
781
Tim Peters39dce292000-08-15 03:34:48 +0000782 fractpart = modf(v, &intpart);
Tim Peters39dce292000-08-15 03:34:48 +0000783 if (fractpart == 0.0) {
784 /* This must return the same hash as an equal int or long. */
785 if (intpart > LONG_MAX || -intpart > LONG_MAX) {
786 /* Convert to long and use its hash. */
787 PyObject *plong; /* converted to Python long */
788 if (Py_IS_INFINITY(intpart))
789 /* can't convert to long int -- arbitrary */
790 v = v < 0 ? -271828.0 : 314159.0;
791 plong = PyLong_FromDouble(v);
792 if (plong == NULL)
793 return -1;
794 x = PyObject_Hash(plong);
795 Py_DECREF(plong);
796 return x;
797 }
798 /* Fits in a C long == a Python int, so is its own hash. */
799 x = (long)intpart;
800 if (x == -1)
801 x = -2;
802 return x;
803 }
804 /* The fractional part is non-zero, so we don't have to worry about
805 * making this match the hash of some other type.
806 * Use frexp to get at the bits in the double.
Fred Drake13634cf2000-06-29 19:17:04 +0000807 * Since the VAX D double format has 56 mantissa bits, which is the
808 * most of any double format in use, each of these parts may have as
809 * many as (but no more than) 56 significant bits.
Tim Peters39dce292000-08-15 03:34:48 +0000810 * So, assuming sizeof(long) >= 4, each part can be broken into two
811 * longs; frexp and multiplication are used to do that.
812 * Also, since the Cray double format has 15 exponent bits, which is
813 * the most of any double format in use, shifting the exponent field
814 * left by 15 won't overflow a long (again assuming sizeof(long) >= 4).
Fred Drake13634cf2000-06-29 19:17:04 +0000815 */
Tim Peters39dce292000-08-15 03:34:48 +0000816 v = frexp(v, &expo);
817 v *= 2147483648.0; /* 2**31 */
818 hipart = (long)v; /* take the top 32 bits */
819 v = (v - (double)hipart) * 2147483648.0; /* get the next 32 bits */
820 x = hipart + (long)v + (expo << 15);
821 if (x == -1)
822 x = -2;
823 return x;
Fred Drake13634cf2000-06-29 19:17:04 +0000824}
825
826long
Fred Drake100814d2000-07-09 15:48:49 +0000827_Py_HashPointer(void *p)
Fred Drake13634cf2000-06-29 19:17:04 +0000828{
829#if SIZEOF_LONG >= SIZEOF_VOID_P
830 return (long)p;
831#else
832 /* convert to a Python long and hash that */
833 PyObject* longobj;
834 long x;
Tim Peters803526b2002-07-07 05:13:56 +0000835
Fred Drake13634cf2000-06-29 19:17:04 +0000836 if ((longobj = PyLong_FromVoidPtr(p)) == NULL) {
837 x = -1;
838 goto finally;
839 }
840 x = PyObject_Hash(longobj);
Tim Peters803526b2002-07-07 05:13:56 +0000841
Fred Drake13634cf2000-06-29 19:17:04 +0000842finally:
843 Py_XDECREF(longobj);
844 return x;
845#endif
846}
847
848
Guido van Rossum9bfef441993-03-29 10:43:31 +0000849long
Fred Drake100814d2000-07-09 15:48:49 +0000850PyObject_Hash(PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000851{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000852 PyTypeObject *tp = v->ob_type;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000853 if (tp->tp_hash != NULL)
854 return (*tp->tp_hash)(v);
Guido van Rossum50e9fb92006-08-17 05:42:55 +0000855 /* Otherwise, the object can't be hashed */
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000856 PyErr_Format(PyExc_TypeError, "unhashable type: '%.200s'",
857 v->ob_type->tp_name);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000858 return -1;
859}
860
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000861PyObject *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000862PyObject_GetAttrString(PyObject *v, const char *name)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000863{
Tim Peters6d6c1a32001-08-02 04:15:00 +0000864 PyObject *w, *res;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000865
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000866 if (Py_Type(v)->tp_getattr != NULL)
867 return (*Py_Type(v)->tp_getattr)(v, (char*)name);
Martin v. Löwis5b222132007-06-10 09:51:05 +0000868 w = PyUnicode_InternFromString(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000869 if (w == NULL)
870 return NULL;
871 res = PyObject_GetAttr(v, w);
872 Py_XDECREF(w);
873 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000874}
875
876int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000877PyObject_HasAttrString(PyObject *v, const char *name)
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000878{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000879 PyObject *res = PyObject_GetAttrString(v, name);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000880 if (res != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000881 Py_DECREF(res);
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000882 return 1;
883 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000884 PyErr_Clear();
Guido van Rossumed18fdc1993-07-11 19:55:34 +0000885 return 0;
886}
887
888int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000889PyObject_SetAttrString(PyObject *v, const char *name, PyObject *w)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000890{
Tim Peters6d6c1a32001-08-02 04:15:00 +0000891 PyObject *s;
892 int res;
Guido van Rossumd8eb1b31996-08-09 20:52:03 +0000893
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000894 if (Py_Type(v)->tp_setattr != NULL)
895 return (*Py_Type(v)->tp_setattr)(v, (char*)name, w);
Martin v. Löwis5b222132007-06-10 09:51:05 +0000896 s = PyUnicode_InternFromString(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000897 if (s == NULL)
898 return -1;
899 res = PyObject_SetAttr(v, s, w);
900 Py_XDECREF(s);
901 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000902}
903
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000904PyObject *
Fred Drake100814d2000-07-09 15:48:49 +0000905PyObject_GetAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000906{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000907 PyTypeObject *tp = Py_Type(v);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000908
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000909 if (!PyUnicode_Check(name)) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000910 PyErr_Format(PyExc_TypeError,
911 "attribute name must be string, not '%.200s'",
912 name->ob_type->tp_name);
913 return NULL;
Jeremy Hylton99a8f902000-06-23 14:36:32 +0000914 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000915 if (tp->tp_getattro != NULL)
916 return (*tp->tp_getattro)(v, name);
917 if (tp->tp_getattr != NULL)
Martin v. Löwis5b222132007-06-10 09:51:05 +0000918 return (*tp->tp_getattr)(v, PyUnicode_AsString(name));
Tim Peters6d6c1a32001-08-02 04:15:00 +0000919 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000920 "'%.50s' object has no attribute '%U'",
921 tp->tp_name, name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000922 return NULL;
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000923}
924
925int
Fred Drake100814d2000-07-09 15:48:49 +0000926PyObject_HasAttr(PyObject *v, PyObject *name)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000927{
928 PyObject *res = PyObject_GetAttr(v, name);
929 if (res != NULL) {
930 Py_DECREF(res);
931 return 1;
932 }
933 PyErr_Clear();
934 return 0;
935}
936
937int
Fred Drake100814d2000-07-09 15:48:49 +0000938PyObject_SetAttr(PyObject *v, PyObject *name, PyObject *value)
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000939{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000940 PyTypeObject *tp = Py_Type(v);
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000941 int err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000942
Martin v. Löwis5b222132007-06-10 09:51:05 +0000943 if (!PyUnicode_Check(name)) {
944 PyErr_Format(PyExc_TypeError,
945 "attribute name must be string, not '%.200s'",
946 name->ob_type->tp_name);
947 return -1;
Jeremy Hylton99a8f902000-06-23 14:36:32 +0000948 }
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000949 Py_INCREF(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000950
Martin v. Löwis5b222132007-06-10 09:51:05 +0000951 PyUnicode_InternInPlace(&name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000952 if (tp->tp_setattro != NULL) {
953 err = (*tp->tp_setattro)(v, name, value);
954 Py_DECREF(name);
955 return err;
Marc-André Lemburge44e5072000-09-18 16:20:57 +0000956 }
Tim Peters6d6c1a32001-08-02 04:15:00 +0000957 if (tp->tp_setattr != NULL) {
Martin v. Löwis5b222132007-06-10 09:51:05 +0000958 err = (*tp->tp_setattr)(v, PyUnicode_AsString(name), value);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000959 Py_DECREF(name);
960 return err;
961 }
Guido van Rossum98ff96a1997-05-20 18:34:44 +0000962 Py_DECREF(name);
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000963 assert(name->ob_refcnt >= 1);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000964 if (tp->tp_getattr == NULL && tp->tp_getattro == NULL)
965 PyErr_Format(PyExc_TypeError,
966 "'%.100s' object has no attributes "
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000967 "(%s .%U)",
Tim Peters6d6c1a32001-08-02 04:15:00 +0000968 tp->tp_name,
969 value==NULL ? "del" : "assign to",
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000970 name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000971 else
972 PyErr_Format(PyExc_TypeError,
973 "'%.100s' object has only read-only attributes "
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000974 "(%s .%U)",
Tim Peters6d6c1a32001-08-02 04:15:00 +0000975 tp->tp_name,
976 value==NULL ? "del" : "assign to",
Walter Dörwaldd376dd92007-06-11 15:37:20 +0000977 name);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000978 return -1;
979}
980
981/* Helper to get a pointer to an object's __dict__ slot, if any */
982
983PyObject **
984_PyObject_GetDictPtr(PyObject *obj)
985{
Martin v. Löwis725507b2006-03-07 12:08:51 +0000986 Py_ssize_t dictoffset;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000987 PyTypeObject *tp = Py_Type(obj);
Tim Peters6d6c1a32001-08-02 04:15:00 +0000988
Tim Peters6d6c1a32001-08-02 04:15:00 +0000989 dictoffset = tp->tp_dictoffset;
990 if (dictoffset == 0)
991 return NULL;
992 if (dictoffset < 0) {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000993 Py_ssize_t tsize;
Guido van Rossum2eb0b872002-03-01 22:24:49 +0000994 size_t size;
995
996 tsize = ((PyVarObject *)obj)->ob_size;
997 if (tsize < 0)
998 tsize = -tsize;
999 size = _PyObject_VAR_SIZE(tp, tsize);
1000
Tim Peters6d483d32001-10-06 21:27:34 +00001001 dictoffset += (long)size;
1002 assert(dictoffset > 0);
1003 assert(dictoffset % SIZEOF_VOID_P == 0);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001004 }
1005 return (PyObject **) ((char *)obj + dictoffset);
1006}
1007
Tim Peters6d6c1a32001-08-02 04:15:00 +00001008PyObject *
Raymond Hettinger1da1dbf2003-03-17 19:46:11 +00001009PyObject_SelfIter(PyObject *obj)
Raymond Hettinger01538262003-03-17 08:24:35 +00001010{
1011 Py_INCREF(obj);
1012 return obj;
1013}
1014
Michael W. Hudson1593f502004-09-14 17:09:47 +00001015/* Generic GetAttr functions - put these in your tp_[gs]etattro slot */
1016
Raymond Hettinger01538262003-03-17 08:24:35 +00001017PyObject *
Tim Peters6d6c1a32001-08-02 04:15:00 +00001018PyObject_GenericGetAttr(PyObject *obj, PyObject *name)
1019{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001020 PyTypeObject *tp = Py_Type(obj);
Guido van Rossum056fbf42002-08-19 19:22:50 +00001021 PyObject *descr = NULL;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001022 PyObject *res = NULL;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001023 descrgetfunc f;
Martin v. Löwis725507b2006-03-07 12:08:51 +00001024 Py_ssize_t dictoffset;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001025 PyObject **dictptr;
1026
Martin v. Löwis5b222132007-06-10 09:51:05 +00001027 if (!PyUnicode_Check(name)){
1028 PyErr_Format(PyExc_TypeError,
1029 "attribute name must be string, not '%.200s'",
1030 name->ob_type->tp_name);
1031 return NULL;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001032 }
1033 else
1034 Py_INCREF(name);
1035
Tim Peters6d6c1a32001-08-02 04:15:00 +00001036 if (tp->tp_dict == NULL) {
Guido van Rossum528b7eb2001-08-07 17:24:28 +00001037 if (PyType_Ready(tp) < 0)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001038 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001039 }
1040
Guido van Rossum056fbf42002-08-19 19:22:50 +00001041 /* Inline _PyType_Lookup */
1042 {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001043 Py_ssize_t i, n;
Guido van Rossum056fbf42002-08-19 19:22:50 +00001044 PyObject *mro, *base, *dict;
1045
1046 /* Look in tp_dict of types in MRO */
1047 mro = tp->tp_mro;
1048 assert(mro != NULL);
1049 assert(PyTuple_Check(mro));
1050 n = PyTuple_GET_SIZE(mro);
1051 for (i = 0; i < n; i++) {
1052 base = PyTuple_GET_ITEM(mro, i);
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001053 assert(PyType_Check(base));
1054 dict = ((PyTypeObject *)base)->tp_dict;
Guido van Rossum056fbf42002-08-19 19:22:50 +00001055 assert(dict && PyDict_Check(dict));
1056 descr = PyDict_GetItem(dict, name);
1057 if (descr != NULL)
1058 break;
1059 }
1060 }
1061
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001062 Py_XINCREF(descr);
1063
Tim Peters6d6c1a32001-08-02 04:15:00 +00001064 f = NULL;
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00001065 if (descr != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001066 f = descr->ob_type->tp_descr_get;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001067 if (f != NULL && PyDescr_IsData(descr)) {
1068 res = f(descr, obj, (PyObject *)obj->ob_type);
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001069 Py_DECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001070 goto done;
1071 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001072 }
1073
Guido van Rossumc66ff442002-08-19 16:50:48 +00001074 /* Inline _PyObject_GetDictPtr */
1075 dictoffset = tp->tp_dictoffset;
1076 if (dictoffset != 0) {
1077 PyObject *dict;
1078 if (dictoffset < 0) {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001079 Py_ssize_t tsize;
Guido van Rossumc66ff442002-08-19 16:50:48 +00001080 size_t size;
1081
1082 tsize = ((PyVarObject *)obj)->ob_size;
1083 if (tsize < 0)
1084 tsize = -tsize;
1085 size = _PyObject_VAR_SIZE(tp, tsize);
1086
1087 dictoffset += (long)size;
1088 assert(dictoffset > 0);
1089 assert(dictoffset % SIZEOF_VOID_P == 0);
1090 }
1091 dictptr = (PyObject **) ((char *)obj + dictoffset);
1092 dict = *dictptr;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001093 if (dict != NULL) {
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001094 res = PyDict_GetItem(dict, name);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001095 if (res != NULL) {
1096 Py_INCREF(res);
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001097 Py_XDECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001098 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001099 }
1100 }
1101 }
1102
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001103 if (f != NULL) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001104 res = f(descr, obj, (PyObject *)Py_Type(obj));
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001105 Py_DECREF(descr);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001106 goto done;
1107 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001108
1109 if (descr != NULL) {
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001110 res = descr;
Michael W. Hudsonb2c7de42003-08-15 13:07:47 +00001111 /* descr was already increfed above */
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001112 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001113 }
1114
1115 PyErr_Format(PyExc_AttributeError,
1116 "'%.50s' object has no attribute '%.400s'",
Martin v. Löwis5b222132007-06-10 09:51:05 +00001117 tp->tp_name, PyUnicode_AsString(name));
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001118 done:
1119 Py_DECREF(name);
1120 return res;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001121}
1122
1123int
1124PyObject_GenericSetAttr(PyObject *obj, PyObject *name, PyObject *value)
1125{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001126 PyTypeObject *tp = Py_Type(obj);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001127 PyObject *descr;
1128 descrsetfunc f;
1129 PyObject **dictptr;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001130 int res = -1;
1131
Martin v. Löwis5b222132007-06-10 09:51:05 +00001132 if (!PyUnicode_Check(name)){
1133 PyErr_Format(PyExc_TypeError,
1134 "attribute name must be string, not '%.200s'",
1135 name->ob_type->tp_name);
1136 return -1;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001137 }
1138 else
1139 Py_INCREF(name);
Tim Peters6d6c1a32001-08-02 04:15:00 +00001140
1141 if (tp->tp_dict == NULL) {
Guido van Rossum528b7eb2001-08-07 17:24:28 +00001142 if (PyType_Ready(tp) < 0)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001143 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001144 }
1145
1146 descr = _PyType_Lookup(tp, name);
1147 f = NULL;
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00001148 if (descr != NULL) {
Tim Peters6d6c1a32001-08-02 04:15:00 +00001149 f = descr->ob_type->tp_descr_set;
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001150 if (f != NULL && PyDescr_IsData(descr)) {
1151 res = f(descr, obj, value);
1152 goto done;
1153 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001154 }
1155
1156 dictptr = _PyObject_GetDictPtr(obj);
1157 if (dictptr != NULL) {
1158 PyObject *dict = *dictptr;
1159 if (dict == NULL && value != NULL) {
1160 dict = PyDict_New();
1161 if (dict == NULL)
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001162 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001163 *dictptr = dict;
1164 }
1165 if (dict != NULL) {
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);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001172 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001173 }
1174 }
1175
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001176 if (f != NULL) {
1177 res = f(descr, obj, value);
1178 goto done;
1179 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00001180
1181 if (descr == NULL) {
1182 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +00001183 "'%.100s' object has no attribute '%U'",
1184 tp->tp_name, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001185 goto done;
Tim Peters6d6c1a32001-08-02 04:15:00 +00001186 }
1187
1188 PyErr_Format(PyExc_AttributeError,
Walter Dörwaldd376dd92007-06-11 15:37:20 +00001189 "'%.50s' object attribute '%U' is read-only",
1190 tp->tp_name, name);
Guido van Rossumebca9fc2001-12-04 15:54:53 +00001191 done:
1192 Py_DECREF(name);
1193 return res;
Guido van Rossum98ff96a1997-05-20 18:34:44 +00001194}
1195
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001196/* Test a value used as condition, e.g., in a for or if statement.
1197 Return -1 if an error occurred */
1198
1199int
Fred Drake100814d2000-07-09 15:48:49 +00001200PyObject_IsTrue(PyObject *v)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001201{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001202 Py_ssize_t res;
Guido van Rossum6248f442002-08-24 06:31:34 +00001203 if (v == Py_True)
1204 return 1;
1205 if (v == Py_False)
1206 return 0;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001207 if (v == Py_None)
Neal Norwitz51290d32002-06-13 21:32:44 +00001208 return 0;
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001209 else if (v->ob_type->tp_as_number != NULL &&
Jack Diederich4dafcc42006-11-28 19:15:13 +00001210 v->ob_type->tp_as_number->nb_bool != NULL)
1211 res = (*v->ob_type->tp_as_number->nb_bool)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001212 else if (v->ob_type->tp_as_mapping != NULL &&
1213 v->ob_type->tp_as_mapping->mp_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001214 res = (*v->ob_type->tp_as_mapping->mp_length)(v);
Guido van Rossum1c4f4581998-05-22 00:53:24 +00001215 else if (v->ob_type->tp_as_sequence != NULL &&
1216 v->ob_type->tp_as_sequence->sq_length != NULL)
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001217 res = (*v->ob_type->tp_as_sequence->sq_length)(v);
1218 else
Neal Norwitz51290d32002-06-13 21:32:44 +00001219 return 1;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001220 /* if it is negative, it should be either -1 or -2 */
1221 return (res > 0) ? 1 : Py_SAFE_DOWNCAST(res, Py_ssize_t, int);
Guido van Rossum6ac258d1993-05-12 08:24:20 +00001222}
1223
Tim Peters803526b2002-07-07 05:13:56 +00001224/* equivalent of 'not v'
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001225 Return -1 if an error occurred */
1226
1227int
Fred Drake100814d2000-07-09 15:48:49 +00001228PyObject_Not(PyObject *v)
Guido van Rossumc3d3f961998-04-09 17:53:59 +00001229{
1230 int res;
1231 res = PyObject_IsTrue(v);
1232 if (res < 0)
1233 return res;
1234 return res == 0;
1235}
1236
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001237/* Test whether an object can be called */
1238
1239int
Fred Drake100814d2000-07-09 15:48:49 +00001240PyCallable_Check(PyObject *x)
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001241{
1242 if (x == NULL)
1243 return 0;
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001244 return x->ob_type->tp_call != NULL;
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001245}
1246
Georg Brandle32b4222007-03-10 22:13:27 +00001247/* ------------------------- PyObject_Dir() helpers ------------------------- */
1248
Tim Peters7eea37e2001-09-04 22:08:56 +00001249/* Helper for PyObject_Dir.
1250 Merge the __dict__ of aclass into dict, and recursively also all
1251 the __dict__s of aclass's base classes. The order of merging isn't
1252 defined, as it's expected that only the final set of dict keys is
1253 interesting.
1254 Return 0 on success, -1 on error.
1255*/
1256
1257static int
1258merge_class_dict(PyObject* dict, PyObject* aclass)
1259{
1260 PyObject *classdict;
1261 PyObject *bases;
1262
1263 assert(PyDict_Check(dict));
1264 assert(aclass);
1265
1266 /* Merge in the type's dict (if any). */
1267 classdict = PyObject_GetAttrString(aclass, "__dict__");
1268 if (classdict == NULL)
1269 PyErr_Clear();
1270 else {
1271 int status = PyDict_Update(dict, classdict);
1272 Py_DECREF(classdict);
1273 if (status < 0)
1274 return -1;
1275 }
1276
1277 /* Recursively merge in the base types' (if any) dicts. */
1278 bases = PyObject_GetAttrString(aclass, "__bases__");
Tim Petersbc7e8632001-09-16 20:33:22 +00001279 if (bases == NULL)
1280 PyErr_Clear();
1281 else {
Guido van Rossum44022412002-05-13 18:29:46 +00001282 /* We have no guarantee that bases is a real tuple */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001283 Py_ssize_t i, n;
Guido van Rossum44022412002-05-13 18:29:46 +00001284 n = PySequence_Size(bases); /* This better be right */
1285 if (n < 0)
1286 PyErr_Clear();
1287 else {
1288 for (i = 0; i < n; i++) {
Tim Peters18e70832003-02-05 19:35:19 +00001289 int status;
Guido van Rossum44022412002-05-13 18:29:46 +00001290 PyObject *base = PySequence_GetItem(bases, i);
1291 if (base == NULL) {
1292 Py_DECREF(bases);
1293 return -1;
1294 }
Tim Peters18e70832003-02-05 19:35:19 +00001295 status = merge_class_dict(dict, base);
1296 Py_DECREF(base);
1297 if (status < 0) {
Guido van Rossum44022412002-05-13 18:29:46 +00001298 Py_DECREF(bases);
1299 return -1;
1300 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001301 }
1302 }
1303 Py_DECREF(bases);
1304 }
1305 return 0;
1306}
1307
Georg Brandle32b4222007-03-10 22:13:27 +00001308/* Helper for PyObject_Dir without arguments: returns the local scope. */
1309static PyObject *
Guido van Rossumad7d8d12007-04-13 01:39:34 +00001310_dir_locals(void)
Tim Peters305b5852001-09-17 02:38:46 +00001311{
Georg Brandled3b8382007-03-12 13:15:14 +00001312 PyObject *names;
Georg Brandle32b4222007-03-10 22:13:27 +00001313 PyObject *locals = PyEval_GetLocals();
Tim Peters305b5852001-09-17 02:38:46 +00001314
Georg Brandle32b4222007-03-10 22:13:27 +00001315 if (locals == NULL) {
1316 PyErr_SetString(PyExc_SystemError, "frame does not exist");
1317 return NULL;
Tim Peters305b5852001-09-17 02:38:46 +00001318 }
1319
Georg Brandled3b8382007-03-12 13:15:14 +00001320 names = PyMapping_Keys(locals);
1321 if (!names)
1322 return NULL;
1323 if (!PyList_Check(names)) {
1324 PyErr_Format(PyExc_TypeError,
1325 "dir(): expected keys() of locals to be a list, "
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001326 "not '%.200s'", Py_Type(names)->tp_name);
Georg Brandled3b8382007-03-12 13:15:14 +00001327 Py_DECREF(names);
1328 return NULL;
1329 }
Georg Brandle32b4222007-03-10 22:13:27 +00001330 /* the locals don't need to be DECREF'd */
Georg Brandled3b8382007-03-12 13:15:14 +00001331 return names;
Georg Brandle32b4222007-03-10 22:13:27 +00001332}
1333
1334/* Helper for PyObject_Dir of type objects: returns __dict__ and __bases__.
1335 We deliberately don't suck up its __class__, as methods belonging to the
1336 metaclass would probably be more confusing than helpful.
1337*/
1338static PyObject *
1339_specialized_dir_type(PyObject *obj)
1340{
1341 PyObject *result = NULL;
1342 PyObject *dict = PyDict_New();
1343
1344 if (dict != NULL && merge_class_dict(dict, obj) == 0)
1345 result = PyDict_Keys(dict);
1346
1347 Py_XDECREF(dict);
Tim Peters305b5852001-09-17 02:38:46 +00001348 return result;
1349}
1350
Georg Brandle32b4222007-03-10 22:13:27 +00001351/* Helper for PyObject_Dir of module objects: returns the module's __dict__. */
1352static PyObject *
1353_specialized_dir_module(PyObject *obj)
Tim Peters7eea37e2001-09-04 22:08:56 +00001354{
Georg Brandle32b4222007-03-10 22:13:27 +00001355 PyObject *result = NULL;
1356 PyObject *dict = PyObject_GetAttrString(obj, "__dict__");
Tim Peters7eea37e2001-09-04 22:08:56 +00001357
Georg Brandle32b4222007-03-10 22:13:27 +00001358 if (dict != NULL) {
1359 if (PyDict_Check(dict))
1360 result = PyDict_Keys(dict);
1361 else {
1362 PyErr_Format(PyExc_TypeError,
1363 "%.200s.__dict__ is not a dictionary",
1364 PyModule_GetName(obj));
Guido van Rossum8dbd3d82001-09-10 18:27:43 +00001365 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001366 }
1367
Georg Brandle32b4222007-03-10 22:13:27 +00001368 Py_XDECREF(dict);
1369 return result;
1370}
Tim Peters7eea37e2001-09-04 22:08:56 +00001371
Georg Brandle32b4222007-03-10 22:13:27 +00001372/* Helper for PyObject_Dir of generic objects: returns __dict__, __class__,
1373 and recursively up the __class__.__bases__ chain.
1374*/
1375static PyObject *
1376_generic_dir(PyObject *obj)
1377{
1378 PyObject *result = NULL;
1379 PyObject *dict = NULL;
1380 PyObject *itsclass = NULL;
1381
1382 /* Get __dict__ (which may or may not be a real dict...) */
1383 dict = PyObject_GetAttrString(obj, "__dict__");
1384 if (dict == NULL) {
1385 PyErr_Clear();
1386 dict = PyDict_New();
1387 }
1388 else if (!PyDict_Check(dict)) {
1389 Py_DECREF(dict);
1390 dict = PyDict_New();
1391 }
Tim Peters7eea37e2001-09-04 22:08:56 +00001392 else {
Georg Brandle32b4222007-03-10 22:13:27 +00001393 /* Copy __dict__ to avoid mutating it. */
1394 PyObject *temp = PyDict_Copy(dict);
1395 Py_DECREF(dict);
1396 dict = temp;
Tim Peters7eea37e2001-09-04 22:08:56 +00001397 }
1398
Georg Brandle32b4222007-03-10 22:13:27 +00001399 if (dict == NULL)
Raymond Hettinger2a7dede2004-08-07 04:55:30 +00001400 goto error;
Tim Peters7eea37e2001-09-04 22:08:56 +00001401
Georg Brandle32b4222007-03-10 22:13:27 +00001402 /* Merge in attrs reachable from its class. */
1403 itsclass = PyObject_GetAttrString(obj, "__class__");
1404 if (itsclass == NULL)
1405 /* XXX(tomer): Perhaps fall back to obj->ob_type if no
1406 __class__ exists? */
1407 PyErr_Clear();
1408 else {
1409 if (merge_class_dict(dict, itsclass) != 0)
1410 goto error;
1411 }
1412
1413 result = PyDict_Keys(dict);
Tim Peters7eea37e2001-09-04 22:08:56 +00001414 /* fall through */
Georg Brandle32b4222007-03-10 22:13:27 +00001415error:
1416 Py_XDECREF(itsclass);
1417 Py_XDECREF(dict);
1418 return result;
1419}
1420
1421/* Helper for PyObject_Dir: object introspection.
1422 This calls one of the above specialized versions if no __dir__ method
1423 exists. */
1424static PyObject *
1425_dir_object(PyObject *obj)
1426{
1427 PyObject * result = NULL;
1428 PyObject * dirfunc = PyObject_GetAttrString((PyObject*)obj->ob_type,
1429 "__dir__");
1430
1431 assert(obj);
1432 if (dirfunc == NULL) {
1433 /* use default implementation */
1434 PyErr_Clear();
1435 if (PyModule_Check(obj))
1436 result = _specialized_dir_module(obj);
1437 else if (PyType_Check(obj))
1438 result = _specialized_dir_type(obj);
1439 else
1440 result = _generic_dir(obj);
1441 }
1442 else {
1443 /* use __dir__ */
1444 result = PyObject_CallFunctionObjArgs(dirfunc, obj, NULL);
1445 Py_DECREF(dirfunc);
1446 if (result == NULL)
1447 return NULL;
1448
1449 /* result must be a list */
1450 /* XXX(gbrandl): could also check if all items are strings */
1451 if (!PyList_Check(result)) {
1452 PyErr_Format(PyExc_TypeError,
1453 "__dir__() must return a list, not %.200s",
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001454 Py_Type(result)->tp_name);
Georg Brandle32b4222007-03-10 22:13:27 +00001455 Py_DECREF(result);
1456 result = NULL;
1457 }
1458 }
1459
1460 return result;
1461}
1462
1463/* Implementation of dir() -- if obj is NULL, returns the names in the current
1464 (local) scope. Otherwise, performs introspection of the object: returns a
1465 sorted list of attribute names (supposedly) accessible from the object
1466*/
1467PyObject *
1468PyObject_Dir(PyObject *obj)
1469{
1470 PyObject * result;
1471
1472 if (obj == NULL)
1473 /* no object -- introspect the locals */
1474 result = _dir_locals();
1475 else
1476 /* object -- introspect the object */
1477 result = _dir_object(obj);
1478
1479 assert(result == NULL || PyList_Check(result));
1480
1481 if (result != NULL && PyList_Sort(result) != 0) {
1482 /* sorting the list failed */
1483 Py_DECREF(result);
1484 result = NULL;
1485 }
1486
Tim Peters7eea37e2001-09-04 22:08:56 +00001487 return result;
1488}
Guido van Rossum49b11fe1995-01-26 00:38:22 +00001489
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001490/*
1491NoObject is usable as a non-NULL undefined value, used by the macro None.
1492There is (and should be!) no way to create other objects of this type,
Guido van Rossum3f5da241990-12-20 15:06:42 +00001493so there is exactly one (which is indestructible, by the way).
Guido van Rossumba21a492001-08-16 08:17:26 +00001494(XXX This type and the type of NotImplemented below should be unified.)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001495*/
1496
Guido van Rossum0c182a11992-03-27 17:26:13 +00001497/* ARGSUSED */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001498static PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001499none_repr(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001500{
Walter Dörwald1ab83302007-05-18 17:15:44 +00001501 return PyUnicode_FromString("None");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001502}
1503
Barry Warsaw9bf16442001-01-23 16:24:35 +00001504/* ARGUSED */
1505static void
Tim Peters803526b2002-07-07 05:13:56 +00001506none_dealloc(PyObject* ignore)
Barry Warsaw9bf16442001-01-23 16:24:35 +00001507{
1508 /* This should never get called, but we also don't want to SEGV if
1509 * we accidently decref None out of existance.
1510 */
Martin v. Löwis3f19b102002-08-07 16:21:51 +00001511 Py_FatalError("deallocating None");
Barry Warsaw9bf16442001-01-23 16:24:35 +00001512}
1513
1514
Guido van Rossumba21a492001-08-16 08:17:26 +00001515static PyTypeObject PyNone_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001516 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumba21a492001-08-16 08:17:26 +00001517 "NoneType",
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001518 0,
1519 0,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001520 none_dealloc, /*tp_dealloc*/ /*never called*/
Guido van Rossum7066dd71992-09-17 17:54:56 +00001521 0, /*tp_print*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001522 0, /*tp_getattr*/
1523 0, /*tp_setattr*/
1524 0, /*tp_compare*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001525 none_repr, /*tp_repr*/
Guido van Rossum3f5da241990-12-20 15:06:42 +00001526 0, /*tp_as_number*/
1527 0, /*tp_as_sequence*/
1528 0, /*tp_as_mapping*/
Guido van Rossum9bfef441993-03-29 10:43:31 +00001529 0, /*tp_hash */
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001530};
1531
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001532PyObject _Py_NoneStruct = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001533 _PyObject_EXTRA_INIT
1534 1, &PyNone_Type
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001535};
1536
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001537/* NotImplemented is an object that can be used to signal that an
1538 operation is not implemented for the given type combination. */
1539
1540static PyObject *
1541NotImplemented_repr(PyObject *op)
1542{
Walter Dörwald1ab83302007-05-18 17:15:44 +00001543 return PyUnicode_FromString("NotImplemented");
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001544}
1545
1546static PyTypeObject PyNotImplemented_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001547 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumba21a492001-08-16 08:17:26 +00001548 "NotImplementedType",
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001549 0,
1550 0,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001551 none_dealloc, /*tp_dealloc*/ /*never called*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001552 0, /*tp_print*/
1553 0, /*tp_getattr*/
1554 0, /*tp_setattr*/
1555 0, /*tp_compare*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001556 NotImplemented_repr, /*tp_repr*/
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001557 0, /*tp_as_number*/
1558 0, /*tp_as_sequence*/
1559 0, /*tp_as_mapping*/
1560 0, /*tp_hash */
1561};
1562
1563PyObject _Py_NotImplementedStruct = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001564 _PyObject_EXTRA_INIT
1565 1, &PyNotImplemented_Type
Neil Schemenauer5ed85ec2001-01-04 01:48:10 +00001566};
1567
Guido van Rossumba21a492001-08-16 08:17:26 +00001568void
1569_Py_ReadyTypes(void)
1570{
1571 if (PyType_Ready(&PyType_Type) < 0)
1572 Py_FatalError("Can't initialize 'type'");
1573
Fred Drake0a4dd392004-07-02 18:57:45 +00001574 if (PyType_Ready(&_PyWeakref_RefType) < 0)
1575 Py_FatalError("Can't initialize 'weakref'");
1576
Guido van Rossum77f6a652002-04-03 22:41:51 +00001577 if (PyType_Ready(&PyBool_Type) < 0)
1578 Py_FatalError("Can't initialize 'bool'");
1579
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00001580 if (PyType_Ready(&PyBytes_Type) < 0)
1581 Py_FatalError("Can't initialize 'bytes'");
1582
Guido van Rossumcacfc072002-05-24 19:01:59 +00001583 if (PyType_Ready(&PyString_Type) < 0)
1584 Py_FatalError("Can't initialize 'str'");
1585
Guido van Rossumba21a492001-08-16 08:17:26 +00001586 if (PyType_Ready(&PyList_Type) < 0)
1587 Py_FatalError("Can't initialize 'list'");
1588
1589 if (PyType_Ready(&PyNone_Type) < 0)
1590 Py_FatalError("Can't initialize type(None)");
1591
Guido van Rossum50e9fb92006-08-17 05:42:55 +00001592 if (PyType_Ready(Py_Ellipsis->ob_type) < 0)
1593 Py_FatalError("Can't initialize type(Ellipsis)");
1594
Guido van Rossumba21a492001-08-16 08:17:26 +00001595 if (PyType_Ready(&PyNotImplemented_Type) < 0)
1596 Py_FatalError("Can't initialize type(NotImplemented)");
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001597
1598 if (PyType_Ready(&PyCode_Type) < 0)
1599 Py_FatalError("Can't initialize 'code'");
Guido van Rossumba21a492001-08-16 08:17:26 +00001600}
1601
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001602
Guido van Rossum84a90321996-05-22 16:34:47 +00001603#ifdef Py_TRACE_REFS
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001604
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001605void
Fred Drake100814d2000-07-09 15:48:49 +00001606_Py_NewReference(PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001607{
Tim Peters34592512002-07-11 06:23:50 +00001608 _Py_INC_REFTOTAL;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001609 op->ob_refcnt = 1;
Tim Peters7571a0f2003-03-23 17:52:28 +00001610 _Py_AddToAllObjects(op, 1);
Tim Peters34592512002-07-11 06:23:50 +00001611 _Py_INC_TPALLOCS(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001612}
1613
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001614void
Fred Drake100814d2000-07-09 15:48:49 +00001615_Py_ForgetReference(register PyObject *op)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001616{
Guido van Rossumbffd6832000-01-20 22:32:56 +00001617#ifdef SLOW_UNREF_CHECK
Guido van Rossum4c08d552000-03-10 22:55:18 +00001618 register PyObject *p;
Guido van Rossumbffd6832000-01-20 22:32:56 +00001619#endif
Guido van Rossumd7047b31995-01-02 19:07:15 +00001620 if (op->ob_refcnt < 0)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001621 Py_FatalError("UNREF negative refcnt");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001622 if (op == &refchain ||
Guido van Rossumd7047b31995-01-02 19:07:15 +00001623 op->_ob_prev->_ob_next != op || op->_ob_next->_ob_prev != op)
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001624 Py_FatalError("UNREF invalid object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001625#ifdef SLOW_UNREF_CHECK
Guido van Rossum3f5da241990-12-20 15:06:42 +00001626 for (p = refchain._ob_next; p != &refchain; p = p->_ob_next) {
1627 if (p == op)
1628 break;
1629 }
Guido van Rossumd7047b31995-01-02 19:07:15 +00001630 if (p == &refchain) /* Not found */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001631 Py_FatalError("UNREF unknown object");
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001632#endif
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001633 op->_ob_next->_ob_prev = op->_ob_prev;
1634 op->_ob_prev->_ob_next = op->_ob_next;
Guido van Rossum2e8f6141992-09-03 20:32:55 +00001635 op->_ob_next = op->_ob_prev = NULL;
Tim Peters34592512002-07-11 06:23:50 +00001636 _Py_INC_TPFREES(op);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001637}
1638
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001639void
Fred Drake100814d2000-07-09 15:48:49 +00001640_Py_Dealloc(PyObject *op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001641{
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001642 destructor dealloc = Py_Type(op)->tp_dealloc;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001643 _Py_ForgetReference(op);
Guido van Rossum9776adf1994-09-07 14:36:45 +00001644 (*dealloc)(op);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001645}
1646
Tim Peters269b2a62003-04-17 19:52:29 +00001647/* Print all live objects. Because PyObject_Print is called, the
1648 * interpreter must be in a healthy state.
1649 */
Guido van Rossumaacdc9d1996-08-12 21:32:12 +00001650void
Fred Drake100814d2000-07-09 15:48:49 +00001651_Py_PrintReferences(FILE *fp)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001652{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001653 PyObject *op;
Guido van Rossume09fb551997-08-05 02:04:34 +00001654 fprintf(fp, "Remaining objects:\n");
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001655 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next) {
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001656 fprintf(fp, "%p [%" PY_FORMAT_SIZE_T "d] ", op, op->ob_refcnt);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001657 if (PyObject_Print(op, fp, 0) != 0)
1658 PyErr_Clear();
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001659 putc('\n', fp);
1660 }
1661}
1662
Tim Peters269b2a62003-04-17 19:52:29 +00001663/* Print the addresses of all live objects. Unlike _Py_PrintReferences, this
1664 * doesn't make any calls to the Python C API, so is always safe to call.
1665 */
1666void
1667_Py_PrintReferenceAddresses(FILE *fp)
1668{
1669 PyObject *op;
1670 fprintf(fp, "Remaining object addresses:\n");
1671 for (op = refchain._ob_next; op != &refchain; op = op->_ob_next)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001672 fprintf(fp, "%p [%" PY_FORMAT_SIZE_T "d] %s\n", op,
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001673 op->ob_refcnt, Py_Type(op)->tp_name);
Tim Peters269b2a62003-04-17 19:52:29 +00001674}
1675
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001676PyObject *
Fred Drake100814d2000-07-09 15:48:49 +00001677_Py_GetObjects(PyObject *self, PyObject *args)
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001678{
1679 int i, n;
1680 PyObject *t = NULL;
1681 PyObject *res, *op;
1682
1683 if (!PyArg_ParseTuple(args, "i|O", &n, &t))
1684 return NULL;
1685 op = refchain._ob_next;
1686 res = PyList_New(0);
1687 if (res == NULL)
1688 return NULL;
1689 for (i = 0; (n == 0 || i < n) && op != &refchain; i++) {
1690 while (op == self || op == args || op == res || op == t ||
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001691 (t != NULL && Py_Type(op) != (PyTypeObject *) t)) {
Sjoerd Mullender6ec3c651995-08-29 09:18:14 +00001692 op = op->_ob_next;
1693 if (op == &refchain)
1694 return res;
1695 }
1696 if (PyList_Append(res, op) < 0) {
1697 Py_DECREF(res);
1698 return NULL;
1699 }
1700 op = op->_ob_next;
1701 }
1702 return res;
1703}
1704
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001705#endif
Guido van Rossum97ead3f1996-01-12 01:24:09 +00001706
1707
1708/* Hack to force loading of cobject.o */
Guido van Rossumda9c2711996-12-05 21:58:58 +00001709PyTypeObject *_Py_cobject_hack = &PyCObject_Type;
Guido van Rossum84a90321996-05-22 16:34:47 +00001710
1711
1712/* Hack to force loading of abstract.o */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001713Py_ssize_t (*_Py_abstract_hack)(PyObject *) = PyObject_Size;
Guido van Rossume09fb551997-08-05 02:04:34 +00001714
1715
Andrew M. Kuchling1582a3a2000-08-16 12:27:23 +00001716/* Python's malloc wrappers (see pymem.h) */
Guido van Rossume09fb551997-08-05 02:04:34 +00001717
Thomas Wouters334fb892000-07-25 12:56:38 +00001718void *
Fred Drake100814d2000-07-09 15:48:49 +00001719PyMem_Malloc(size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001720{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001721 return PyMem_MALLOC(nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001722}
1723
Thomas Wouters334fb892000-07-25 12:56:38 +00001724void *
1725PyMem_Realloc(void *p, size_t nbytes)
Guido van Rossume09fb551997-08-05 02:04:34 +00001726{
Tim Petersaf3e8de2002-04-12 07:22:56 +00001727 return PyMem_REALLOC(p, nbytes);
Guido van Rossume09fb551997-08-05 02:04:34 +00001728}
1729
1730void
Thomas Wouters334fb892000-07-25 12:56:38 +00001731PyMem_Free(void *p)
Guido van Rossume09fb551997-08-05 02:04:34 +00001732{
Guido van Rossumb18618d2000-05-03 23:44:39 +00001733 PyMem_FREE(p);
1734}
1735
1736
Guido van Rossum86610361998-04-10 22:32:46 +00001737/* These methods are used to control infinite recursion in repr, str, print,
1738 etc. Container objects that may recursively contain themselves,
1739 e.g. builtin dictionaries and lists, should used Py_ReprEnter() and
1740 Py_ReprLeave() to avoid infinite recursion.
1741
1742 Py_ReprEnter() returns 0 the first time it is called for a particular
1743 object and 1 every time thereafter. It returns -1 if an exception
1744 occurred. Py_ReprLeave() has no return value.
1745
1746 See dictobject.c and listobject.c for examples of use.
1747*/
1748
1749#define KEY "Py_Repr"
1750
1751int
Fred Drake100814d2000-07-09 15:48:49 +00001752Py_ReprEnter(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001753{
1754 PyObject *dict;
1755 PyObject *list;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001756 Py_ssize_t i;
Guido van Rossum86610361998-04-10 22:32:46 +00001757
1758 dict = PyThreadState_GetDict();
1759 if (dict == NULL)
Guido van Rossum0fc8f002003-04-15 15:12:39 +00001760 return 0;
Guido van Rossum86610361998-04-10 22:32:46 +00001761 list = PyDict_GetItemString(dict, KEY);
1762 if (list == NULL) {
1763 list = PyList_New(0);
1764 if (list == NULL)
1765 return -1;
1766 if (PyDict_SetItemString(dict, KEY, list) < 0)
1767 return -1;
1768 Py_DECREF(list);
1769 }
1770 i = PyList_GET_SIZE(list);
1771 while (--i >= 0) {
1772 if (PyList_GET_ITEM(list, i) == obj)
1773 return 1;
1774 }
1775 PyList_Append(list, obj);
1776 return 0;
1777}
1778
1779void
Fred Drake100814d2000-07-09 15:48:49 +00001780Py_ReprLeave(PyObject *obj)
Guido van Rossum86610361998-04-10 22:32:46 +00001781{
1782 PyObject *dict;
1783 PyObject *list;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001784 Py_ssize_t i;
Guido van Rossum86610361998-04-10 22:32:46 +00001785
1786 dict = PyThreadState_GetDict();
Guido van Rossumeb909461998-04-11 15:17:34 +00001787 if (dict == NULL)
1788 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001789 list = PyDict_GetItemString(dict, KEY);
Guido van Rossumeb909461998-04-11 15:17:34 +00001790 if (list == NULL || !PyList_Check(list))
1791 return;
Guido van Rossum86610361998-04-10 22:32:46 +00001792 i = PyList_GET_SIZE(list);
1793 /* Count backwards because we always expect obj to be list[-1] */
1794 while (--i >= 0) {
1795 if (PyList_GET_ITEM(list, i) == obj) {
1796 PyList_SetSlice(list, i, i + 1, NULL);
1797 break;
1798 }
1799 }
1800}
Guido van Rossumd724b232000-03-13 16:01:29 +00001801
Tim Peters803526b2002-07-07 05:13:56 +00001802/* Trashcan support. */
Guido van Rossumd724b232000-03-13 16:01:29 +00001803
Tim Peters803526b2002-07-07 05:13:56 +00001804/* Current call-stack depth of tp_dealloc calls. */
Guido van Rossumd724b232000-03-13 16:01:29 +00001805int _PyTrash_delete_nesting = 0;
Guido van Rossume92e6102000-04-24 15:40:53 +00001806
Tim Peters803526b2002-07-07 05:13:56 +00001807/* List of objects that still need to be cleaned up, singly linked via their
1808 * gc headers' gc_prev pointers.
1809 */
1810PyObject *_PyTrash_delete_later = NULL;
Guido van Rossumd724b232000-03-13 16:01:29 +00001811
Tim Peters803526b2002-07-07 05:13:56 +00001812/* Add op to the _PyTrash_delete_later list. Called when the current
1813 * call-stack depth gets large. op must be a currently untracked gc'ed
1814 * object, with refcount 0. Py_DECREF must already have been called on it.
1815 */
Guido van Rossumd724b232000-03-13 16:01:29 +00001816void
Fred Drake100814d2000-07-09 15:48:49 +00001817_PyTrash_deposit_object(PyObject *op)
Guido van Rossumd724b232000-03-13 16:01:29 +00001818{
Tim Peters803526b2002-07-07 05:13:56 +00001819 assert(PyObject_IS_GC(op));
1820 assert(_Py_AS_GC(op)->gc.gc_refs == _PyGC_REFS_UNTRACKED);
1821 assert(op->ob_refcnt == 0);
Neil Schemenauerf589c052002-03-29 03:05:54 +00001822 _Py_AS_GC(op)->gc.gc_prev = (PyGC_Head *)_PyTrash_delete_later;
Guido van Rossume92e6102000-04-24 15:40:53 +00001823 _PyTrash_delete_later = op;
Guido van Rossumd724b232000-03-13 16:01:29 +00001824}
1825
Tim Peters803526b2002-07-07 05:13:56 +00001826/* Dealloccate all the objects in the _PyTrash_delete_later list. Called when
1827 * the call-stack unwinds again.
1828 */
Guido van Rossumd724b232000-03-13 16:01:29 +00001829void
Fred Drake100814d2000-07-09 15:48:49 +00001830_PyTrash_destroy_chain(void)
Guido van Rossumd724b232000-03-13 16:01:29 +00001831{
1832 while (_PyTrash_delete_later) {
Tim Peters803526b2002-07-07 05:13:56 +00001833 PyObject *op = _PyTrash_delete_later;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001834 destructor dealloc = Py_Type(op)->tp_dealloc;
Neil Schemenauerf589c052002-03-29 03:05:54 +00001835
Neil Schemenauerf589c052002-03-29 03:05:54 +00001836 _PyTrash_delete_later =
Tim Peters803526b2002-07-07 05:13:56 +00001837 (PyObject*) _Py_AS_GC(op)->gc.gc_prev;
Neil Schemenauerf589c052002-03-29 03:05:54 +00001838
Tim Peters803526b2002-07-07 05:13:56 +00001839 /* Call the deallocator directly. This used to try to
1840 * fool Py_DECREF into calling it indirectly, but
1841 * Py_DECREF was already called on this object, and in
1842 * assorted non-release builds calling Py_DECREF again ends
1843 * up distorting allocation statistics.
1844 */
1845 assert(op->ob_refcnt == 0);
Guido van Rossumd724b232000-03-13 16:01:29 +00001846 ++_PyTrash_delete_nesting;
Tim Peters803526b2002-07-07 05:13:56 +00001847 (*dealloc)(op);
Guido van Rossumd724b232000-03-13 16:01:29 +00001848 --_PyTrash_delete_nesting;
1849 }
1850}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001851
1852#ifdef __cplusplus
1853}
1854#endif