blob: 27b481152ab3eaec250059b44a62b0a199a8607e [file] [log] [blame]
Guido van Rossum3f5da241990-12-20 15:06:42 +00001/* Built-in functions */
2
Guido van Rossum79f25d91997-04-29 20:08:16 +00003#include "Python.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00004
5#include "node.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00006#include "code.h"
Guido van Rossum5b722181993-03-30 17:46:03 +00007#include "eval.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00008
Guido van Rossum6bf62da1997-04-11 20:37:35 +00009#include <ctype.h>
10
Guido van Rossume2ae77b2001-10-24 20:42:55 +000011#ifdef RISCOS
12#include "unixstuff.h"
13#endif
14
Mark Hammond26cffde2001-05-14 12:17:34 +000015/* The default encoding used by the platform file system APIs
16 Can remain NULL for all platforms that don't have such a concept
17*/
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000018#if defined(MS_WINDOWS) && defined(HAVE_USABLE_WCHAR_T)
Mark Hammond26cffde2001-05-14 12:17:34 +000019const char *Py_FileSystemDefaultEncoding = "mbcs";
Just van Rossumb9b8e9c2003-02-10 09:22:01 +000020#elif defined(__APPLE__)
21const char *Py_FileSystemDefaultEncoding = "utf-8";
Mark Hammond26cffde2001-05-14 12:17:34 +000022#else
23const char *Py_FileSystemDefaultEncoding = NULL; /* use default */
24#endif
Mark Hammondef8b6542001-05-13 08:04:26 +000025
Guido van Rossum12d12c51993-10-26 17:58:25 +000026/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +000027static PyObject *filterstring(PyObject *, PyObject *);
Martin v. Löwis8afd7572003-01-25 22:46:11 +000028#ifdef Py_USING_UNICODE
29static PyObject *filterunicode(PyObject *, PyObject *);
30#endif
Tim Petersdbd9ba62000-07-09 03:09:57 +000031static PyObject *filtertuple (PyObject *, PyObject *);
Guido van Rossum12d12c51993-10-26 17:58:25 +000032
Guido van Rossum79f25d91997-04-29 20:08:16 +000033static PyObject *
Neal Norwitz92e212f2006-04-03 04:48:37 +000034builtin___import__(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +000035{
Neal Norwitz92e212f2006-04-03 04:48:37 +000036 static char *kwlist[] = {"name", "globals", "locals", "fromlist",
37 "level", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +000038 char *name;
Guido van Rossum79f25d91997-04-29 20:08:16 +000039 PyObject *globals = NULL;
40 PyObject *locals = NULL;
41 PyObject *fromlist = NULL;
Thomas Woutersf7f438b2006-02-28 16:09:29 +000042 int level = -1;
Guido van Rossum1ae940a1995-01-02 19:04:15 +000043
Neal Norwitz92e212f2006-04-03 04:48:37 +000044 if (!PyArg_ParseTupleAndKeywords(args, kwds, "s|OOOi:__import__",
45 kwlist, &name, &globals, &locals, &fromlist, &level))
Guido van Rossum1ae940a1995-01-02 19:04:15 +000046 return NULL;
Thomas Woutersf7f438b2006-02-28 16:09:29 +000047 return PyImport_ImportModuleLevel(name, globals, locals,
48 fromlist, level);
Guido van Rossum1ae940a1995-01-02 19:04:15 +000049}
50
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000051PyDoc_STRVAR(import_doc,
Neal Norwitz92e212f2006-04-03 04:48:37 +000052"__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000053\n\
54Import a module. The globals are only used to determine the context;\n\
55they are not modified. The locals are currently unused. The fromlist\n\
56should be a list of names to emulate ``from name import ...'', or an\n\
57empty list to emulate ``import name''.\n\
58When importing a module from a package, note that __import__('A.B', ...)\n\
59returns package A when fromlist is empty, but its submodule B when\n\
Neal Norwitz92e212f2006-04-03 04:48:37 +000060fromlist is not empty. Level is used to determine whether to perform \n\
61absolute or relative imports. -1 is the original strategy of attempting\n\
62both absolute and relative imports, 0 is absolute, a positive number\n\
63is the number of parent directories to search relative to the current module.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000064
Guido van Rossum1ae940a1995-01-02 19:04:15 +000065
Guido van Rossum79f25d91997-04-29 20:08:16 +000066static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000067builtin_abs(PyObject *self, PyObject *v)
Guido van Rossum1ae940a1995-01-02 19:04:15 +000068{
Guido van Rossum09df08a1998-05-22 00:51:39 +000069 return PyNumber_Absolute(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +000070}
71
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000072PyDoc_STRVAR(abs_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000073"abs(number) -> number\n\
74\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000075Return the absolute value of the argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000076
Raymond Hettinger96229b12005-03-11 06:49:40 +000077static PyObject *
78builtin_all(PyObject *self, PyObject *v)
79{
80 PyObject *it, *item;
81
82 it = PyObject_GetIter(v);
83 if (it == NULL)
84 return NULL;
85
86 while ((item = PyIter_Next(it)) != NULL) {
87 int cmp = PyObject_IsTrue(item);
88 Py_DECREF(item);
89 if (cmp < 0) {
90 Py_DECREF(it);
91 return NULL;
92 }
93 if (cmp == 0) {
94 Py_DECREF(it);
95 Py_RETURN_FALSE;
96 }
97 }
98 Py_DECREF(it);
99 if (PyErr_Occurred())
100 return NULL;
101 Py_RETURN_TRUE;
102}
103
104PyDoc_STRVAR(all_doc,
105"all(iterable) -> bool\n\
106\n\
107Return True if bool(x) is True for all values x in the iterable.");
108
109static PyObject *
110builtin_any(PyObject *self, PyObject *v)
111{
112 PyObject *it, *item;
113
114 it = PyObject_GetIter(v);
115 if (it == NULL)
116 return NULL;
117
118 while ((item = PyIter_Next(it)) != NULL) {
119 int cmp = PyObject_IsTrue(item);
120 Py_DECREF(item);
121 if (cmp < 0) {
122 Py_DECREF(it);
123 return NULL;
124 }
125 if (cmp == 1) {
126 Py_DECREF(it);
127 Py_RETURN_TRUE;
128 }
129 }
130 Py_DECREF(it);
131 if (PyErr_Occurred())
132 return NULL;
133 Py_RETURN_FALSE;
134}
135
136PyDoc_STRVAR(any_doc,
137"any(iterable) -> bool\n\
138\n\
139Return True if bool(x) is True for any x in the iterable.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000140
Guido van Rossum79f25d91997-04-29 20:08:16 +0000141static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000142builtin_apply(PyObject *self, PyObject *args)
Guido van Rossumc02e15c1991-12-16 13:03:00 +0000143{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000144 PyObject *func, *alist = NULL, *kwdict = NULL;
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000145 PyObject *t = NULL, *retval = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000146
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000147 if (!PyArg_UnpackTuple(args, "apply", 1, 3, &func, &alist, &kwdict))
Guido van Rossumc02e15c1991-12-16 13:03:00 +0000148 return NULL;
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000149 if (alist != NULL) {
150 if (!PyTuple_Check(alist)) {
151 if (!PySequence_Check(alist)) {
Jeremy Hyltonc862cf42001-01-19 03:25:05 +0000152 PyErr_Format(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000153 "apply() arg 2 expected sequence, found %s",
Jeremy Hyltonc862cf42001-01-19 03:25:05 +0000154 alist->ob_type->tp_name);
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000155 return NULL;
156 }
157 t = PySequence_Tuple(alist);
158 if (t == NULL)
159 return NULL;
160 alist = t;
161 }
Guido van Rossum2d951851994-08-29 12:52:16 +0000162 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000163 if (kwdict != NULL && !PyDict_Check(kwdict)) {
Jeremy Hyltonc862cf42001-01-19 03:25:05 +0000164 PyErr_Format(PyExc_TypeError,
165 "apply() arg 3 expected dictionary, found %s",
166 kwdict->ob_type->tp_name);
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000167 goto finally;
Guido van Rossum681d79a1995-07-18 14:51:37 +0000168 }
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000169 retval = PyEval_CallObjectWithKeywords(func, alist, kwdict);
170 finally:
171 Py_XDECREF(t);
172 return retval;
Guido van Rossumc02e15c1991-12-16 13:03:00 +0000173}
174
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000175PyDoc_STRVAR(apply_doc,
Fred Drakef1fbc622001-01-12 17:05:05 +0000176"apply(object[, args[, kwargs]]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000177\n\
Fred Drake7b912121999-12-23 14:16:55 +0000178Call a callable object with positional arguments taken from the tuple args,\n\
179and keyword arguments taken from the optional dictionary kwargs.\n\
Raymond Hettingerff41c482003-04-06 09:01:11 +0000180Note that classes are callable, as are instances with a __call__() method.\n\
181\n\
182Deprecated since release 2.3. Instead, use the extended call syntax:\n\
183 function(*args, **keywords).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000184
185
Guido van Rossum79f25d91997-04-29 20:08:16 +0000186static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000187builtin_callable(PyObject *self, PyObject *v)
Guido van Rossum2d951851994-08-29 12:52:16 +0000188{
Guido van Rossum77f6a652002-04-03 22:41:51 +0000189 return PyBool_FromLong((long)PyCallable_Check(v));
Guido van Rossum2d951851994-08-29 12:52:16 +0000190}
191
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000192PyDoc_STRVAR(callable_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000193"callable(object) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000194\n\
195Return whether the object is callable (i.e., some kind of function).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000196Note that classes are callable, as are instances with a __call__() method.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000197
198
Guido van Rossum79f25d91997-04-29 20:08:16 +0000199static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000200builtin_filter(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000201{
Guido van Rossumc7903a12002-08-16 07:04:56 +0000202 PyObject *func, *seq, *result, *it, *arg;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000203 Py_ssize_t len; /* guess for result list size */
204 register Py_ssize_t j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000205
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000206 if (!PyArg_UnpackTuple(args, "filter", 2, 2, &func, &seq))
Guido van Rossum12d12c51993-10-26 17:58:25 +0000207 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000208
Tim Peters0e57abf2001-05-02 07:39:38 +0000209 /* Strings and tuples return a result of the same type. */
210 if (PyString_Check(seq))
211 return filterstring(func, seq);
Martin v. Löwis8afd7572003-01-25 22:46:11 +0000212#ifdef Py_USING_UNICODE
213 if (PyUnicode_Check(seq))
214 return filterunicode(func, seq);
215#endif
Tim Peters0e57abf2001-05-02 07:39:38 +0000216 if (PyTuple_Check(seq))
217 return filtertuple(func, seq);
218
Georg Brandle35b6572005-07-19 22:20:20 +0000219 /* Pre-allocate argument list tuple. */
220 arg = PyTuple_New(1);
221 if (arg == NULL)
222 return NULL;
223
Tim Peters0e57abf2001-05-02 07:39:38 +0000224 /* Get iterator. */
225 it = PyObject_GetIter(seq);
226 if (it == NULL)
Georg Brandle35b6572005-07-19 22:20:20 +0000227 goto Fail_arg;
Tim Peters0e57abf2001-05-02 07:39:38 +0000228
229 /* Guess a result list size. */
Armin Rigof5b3e362006-02-11 21:32:43 +0000230 len = _PyObject_LengthHint(seq);
Raymond Hettingerb86269d2004-01-04 11:00:08 +0000231 if (len < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +0000232 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
233 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
234 goto Fail_it;
235 }
Raymond Hettingerb86269d2004-01-04 11:00:08 +0000236 PyErr_Clear();
237 len = 8; /* arbitrary */
Guido van Rossum12d12c51993-10-26 17:58:25 +0000238 }
239
Tim Peters0e57abf2001-05-02 07:39:38 +0000240 /* Get a result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000241 if (PyList_Check(seq) && seq->ob_refcnt == 1) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000242 /* Eww - can modify the list in-place. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000243 Py_INCREF(seq);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000244 result = seq;
245 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000246 else {
Tim Peters0e57abf2001-05-02 07:39:38 +0000247 result = PyList_New(len);
248 if (result == NULL)
249 goto Fail_it;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000250 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000251
Tim Peters0e57abf2001-05-02 07:39:38 +0000252 /* Build the result list. */
Tim Petersf4848da2001-05-05 00:14:56 +0000253 j = 0;
254 for (;;) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000255 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000256 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000257
Tim Peters0e57abf2001-05-02 07:39:38 +0000258 item = PyIter_Next(it);
259 if (item == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +0000260 if (PyErr_Occurred())
261 goto Fail_result_it;
Tim Peters0e57abf2001-05-02 07:39:38 +0000262 break;
Guido van Rossum2d951851994-08-29 12:52:16 +0000263 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000264
Neil Schemenauer68973552003-08-14 20:37:34 +0000265 if (func == (PyObject *)&PyBool_Type || func == Py_None) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000266 ok = PyObject_IsTrue(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000267 }
268 else {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000269 PyObject *good;
270 PyTuple_SET_ITEM(arg, 0, item);
271 good = PyObject_Call(func, arg, NULL);
272 PyTuple_SET_ITEM(arg, 0, NULL);
Guido van Rossum58b68731995-01-10 17:40:55 +0000273 if (good == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000274 Py_DECREF(item);
Tim Peters0e57abf2001-05-02 07:39:38 +0000275 goto Fail_result_it;
Guido van Rossum58b68731995-01-10 17:40:55 +0000276 }
Guido van Rossumc7903a12002-08-16 07:04:56 +0000277 ok = PyObject_IsTrue(good);
278 Py_DECREF(good);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000279 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000280 if (ok) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000281 if (j < len)
282 PyList_SET_ITEM(result, j, item);
Guido van Rossum2d951851994-08-29 12:52:16 +0000283 else {
Barry Warsawfa77e091999-01-28 18:49:12 +0000284 int status = PyList_Append(result, item);
Barry Warsawfa77e091999-01-28 18:49:12 +0000285 Py_DECREF(item);
286 if (status < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000287 goto Fail_result_it;
Guido van Rossum2d951851994-08-29 12:52:16 +0000288 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000289 ++j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000290 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000291 else
292 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000293 }
294
Guido van Rossum12d12c51993-10-26 17:58:25 +0000295
Tim Peters0e57abf2001-05-02 07:39:38 +0000296 /* Cut back result list if len is too big. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000297 if (j < len && PyList_SetSlice(result, j, len, NULL) < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000298 goto Fail_result_it;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000299
Tim Peters3c6b1482001-05-21 08:07:05 +0000300 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000301 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000302 return result;
303
Tim Peters0e57abf2001-05-02 07:39:38 +0000304Fail_result_it:
Guido van Rossum79f25d91997-04-29 20:08:16 +0000305 Py_DECREF(result);
Tim Peters0e57abf2001-05-02 07:39:38 +0000306Fail_it:
307 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000308Fail_arg:
309 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000310 return NULL;
311}
312
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000313PyDoc_STRVAR(filter_doc,
Tim Petersd50e5442002-03-09 00:06:26 +0000314"filter(function or None, sequence) -> list, tuple, or string\n"
315"\n"
316"Return those items of sequence for which function(item) is true. If\n"
317"function is None, return the items that are true. If sequence is a tuple\n"
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000318"or string, return the same type, else return a list.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000319
Guido van Rossum79f25d91997-04-29 20:08:16 +0000320static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000321builtin_chr(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000322{
323 long x;
324 char s[1];
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000325
Guido van Rossum79f25d91997-04-29 20:08:16 +0000326 if (!PyArg_ParseTuple(args, "l:chr", &x))
Guido van Rossum3f5da241990-12-20 15:06:42 +0000327 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000328 if (x < 0 || x >= 256) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000329 PyErr_SetString(PyExc_ValueError,
330 "chr() arg not in range(256)");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000331 return NULL;
332 }
Guido van Rossum6bf62da1997-04-11 20:37:35 +0000333 s[0] = (char)x;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000334 return PyString_FromStringAndSize(s, 1);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000335}
336
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000337PyDoc_STRVAR(chr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000338"chr(i) -> character\n\
339\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000340Return a string of one character with ordinal i; 0 <= i < 256.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000341
342
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000343#ifdef Py_USING_UNICODE
Guido van Rossum79f25d91997-04-29 20:08:16 +0000344static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000345builtin_unichr(PyObject *self, PyObject *args)
Guido van Rossum09095f32000-03-10 23:00:52 +0000346{
347 long x;
Guido van Rossum09095f32000-03-10 23:00:52 +0000348
349 if (!PyArg_ParseTuple(args, "l:unichr", &x))
350 return NULL;
Fredrik Lundh0dcf67e2001-06-26 20:01:56 +0000351
Marc-André Lemburgcc8764c2002-08-11 12:23:04 +0000352 return PyUnicode_FromOrdinal(x);
Guido van Rossum09095f32000-03-10 23:00:52 +0000353}
354
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000355PyDoc_STRVAR(unichr_doc,
Fred Drake078b24f2000-04-13 02:42:50 +0000356"unichr(i) -> Unicode character\n\
Guido van Rossum09095f32000-03-10 23:00:52 +0000357\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000358Return a Unicode string of one character with ordinal i; 0 <= i <= 0x10ffff.");
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000359#endif
Guido van Rossum09095f32000-03-10 23:00:52 +0000360
361
362static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000363builtin_cmp(PyObject *self, PyObject *args)
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000364{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000365 PyObject *a, *b;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000366 int c;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000367
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000368 if (!PyArg_UnpackTuple(args, "cmp", 2, 2, &a, &b))
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000369 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000370 if (PyObject_Cmp(a, b, &c) < 0)
Guido van Rossumc8b6df91997-05-23 00:06:51 +0000371 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000372 return PyInt_FromLong((long)c);
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000373}
374
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000375PyDoc_STRVAR(cmp_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000376"cmp(x, y) -> integer\n\
377\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000378Return negative if x<y, zero if x==y, positive if x>y.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000379
380
Guido van Rossum79f25d91997-04-29 20:08:16 +0000381static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000382builtin_coerce(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000383{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000384 PyObject *v, *w;
385 PyObject *res;
Guido van Rossum5524a591995-01-10 15:26:20 +0000386
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000387 if (!PyArg_UnpackTuple(args, "coerce", 2, 2, &v, &w))
Guido van Rossum5524a591995-01-10 15:26:20 +0000388 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000389 if (PyNumber_Coerce(&v, &w) < 0)
Guido van Rossum04691fc1992-08-12 15:35:34 +0000390 return NULL;
Raymond Hettinger8ae46892003-10-12 19:09:37 +0000391 res = PyTuple_Pack(2, v, w);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000392 Py_DECREF(v);
393 Py_DECREF(w);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000394 return res;
395}
396
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000397PyDoc_STRVAR(coerce_doc,
Martin v. Löwis8d494f32004-08-25 10:42:41 +0000398"coerce(x, y) -> (x1, y1)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000399\n\
Martin v. Löwis8d494f32004-08-25 10:42:41 +0000400Return a tuple consisting of the two numeric arguments converted to\n\
401a common type, using the same rules as used by arithmetic operations.\n\
402If coercion is not possible, raise TypeError.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000403
Guido van Rossum79f25d91997-04-29 20:08:16 +0000404static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000405builtin_compile(PyObject *self, PyObject *args)
Guido van Rossum5b722181993-03-30 17:46:03 +0000406{
407 char *str;
408 char *filename;
409 char *startstr;
410 int start;
Tim Peters6cd6a822001-08-17 22:11:27 +0000411 int dont_inherit = 0;
412 int supplied_flags = 0;
Tim Peters5ba58662001-07-16 02:29:45 +0000413 PyCompilerFlags cf;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000414 PyObject *result = NULL, *cmd, *tmp = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000415 Py_ssize_t length;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000416
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000417 if (!PyArg_ParseTuple(args, "Oss|ii:compile", &cmd, &filename,
Tim Peters6cd6a822001-08-17 22:11:27 +0000418 &startstr, &supplied_flags, &dont_inherit))
Guido van Rossum5b722181993-03-30 17:46:03 +0000419 return NULL;
Tim Peters6cd6a822001-08-17 22:11:27 +0000420
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000421 cf.cf_flags = supplied_flags;
422
423#ifdef Py_USING_UNICODE
424 if (PyUnicode_Check(cmd)) {
425 tmp = PyUnicode_AsUTF8String(cmd);
426 if (tmp == NULL)
427 return NULL;
428 cmd = tmp;
429 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
430 }
431#endif
Just van Rossumb9b8e9c2003-02-10 09:22:01 +0000432 if (PyObject_AsReadBuffer(cmd, (const void **)&str, &length))
433 return NULL;
Tim Peters2c646c92003-02-10 14:48:29 +0000434 if ((size_t)length != strlen(str)) {
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000435 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000436 "compile() expected string without null bytes");
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000437 goto cleanup;
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000438 }
439
Guido van Rossum5b722181993-03-30 17:46:03 +0000440 if (strcmp(startstr, "exec") == 0)
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000441 start = Py_file_input;
Guido van Rossum5b722181993-03-30 17:46:03 +0000442 else if (strcmp(startstr, "eval") == 0)
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000443 start = Py_eval_input;
Guido van Rossum872537c1995-07-07 22:43:42 +0000444 else if (strcmp(startstr, "single") == 0)
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000445 start = Py_single_input;
Guido van Rossum5b722181993-03-30 17:46:03 +0000446 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000447 PyErr_SetString(PyExc_ValueError,
Fred Drake661ea262000-10-24 19:57:45 +0000448 "compile() arg 3 must be 'exec' or 'eval' or 'single'");
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000449 goto cleanup;
Guido van Rossum5b722181993-03-30 17:46:03 +0000450 }
Tim Peters6cd6a822001-08-17 22:11:27 +0000451
Guido van Rossum4b499dd32003-02-13 22:07:59 +0000452 if (supplied_flags &
Martin v. Löwisbd260da2006-02-26 19:42:26 +0000453 ~(PyCF_MASK | PyCF_MASK_OBSOLETE | PyCF_DONT_IMPLY_DEDENT | PyCF_ONLY_AST))
Guido van Rossum4b499dd32003-02-13 22:07:59 +0000454 {
Tim Peters6cd6a822001-08-17 22:11:27 +0000455 PyErr_SetString(PyExc_ValueError,
456 "compile(): unrecognised flags");
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000457 goto cleanup;
Tim Peters6cd6a822001-08-17 22:11:27 +0000458 }
459 /* XXX Warn if (supplied_flags & PyCF_MASK_OBSOLETE) != 0? */
460
Tim Peters6cd6a822001-08-17 22:11:27 +0000461 if (!dont_inherit) {
462 PyEval_MergeCompilerFlags(&cf);
463 }
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000464 result = Py_CompileStringFlags(str, filename, start, &cf);
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000465cleanup:
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000466 Py_XDECREF(tmp);
467 return result;
Guido van Rossum5b722181993-03-30 17:46:03 +0000468}
469
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000470PyDoc_STRVAR(compile_doc,
Tim Peters6cd6a822001-08-17 22:11:27 +0000471"compile(source, filename, mode[, flags[, dont_inherit]]) -> code object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000472\n\
473Compile the source string (a Python module, statement or expression)\n\
474into a code object that can be executed by the exec statement or eval().\n\
475The filename will be used for run-time error messages.\n\
476The mode must be 'exec' to compile a module, 'single' to compile a\n\
Tim Peters6cd6a822001-08-17 22:11:27 +0000477single (interactive) statement, or 'eval' to compile an expression.\n\
478The flags argument, if present, controls which future statements influence\n\
479the compilation of the code.\n\
480The dont_inherit argument, if non-zero, stops the compilation inheriting\n\
481the effects of any future statements in effect in the code calling\n\
482compile; if absent or zero these statements do influence the compilation,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000483in addition to any features explicitly specified.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000484
Guido van Rossum79f25d91997-04-29 20:08:16 +0000485static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000486builtin_dir(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000487{
Tim Peters5d2b77c2001-09-03 05:47:38 +0000488 PyObject *arg = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000489
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000490 if (!PyArg_UnpackTuple(args, "dir", 0, 1, &arg))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000491 return NULL;
Tim Peters7eea37e2001-09-04 22:08:56 +0000492 return PyObject_Dir(arg);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000493}
494
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000495PyDoc_STRVAR(dir_doc,
Tim Peters5d2b77c2001-09-03 05:47:38 +0000496"dir([object]) -> list of strings\n"
497"\n"
498"Return an alphabetized list of names comprising (some of) the attributes\n"
499"of the given object, and of attributes reachable from it:\n"
500"\n"
501"No argument: the names in the current scope.\n"
502"Module object: the module attributes.\n"
Tim Peters37a309d2001-09-04 01:20:04 +0000503"Type or class object: its attributes, and recursively the attributes of\n"
504" its bases.\n"
Tim Peters5d2b77c2001-09-03 05:47:38 +0000505"Otherwise: its attributes, its class's attributes, and recursively the\n"
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000506" attributes of its class's base classes.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000507
Guido van Rossum79f25d91997-04-29 20:08:16 +0000508static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000509builtin_divmod(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000510{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000511 PyObject *v, *w;
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000512
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000513 if (!PyArg_UnpackTuple(args, "divmod", 2, 2, &v, &w))
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000514 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000515 return PyNumber_Divmod(v, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000516}
517
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000518PyDoc_STRVAR(divmod_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000519"divmod(x, y) -> (div, mod)\n\
520\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000521Return the tuple ((x-x%y)/y, x%y). Invariant: div*y + mod == x.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000522
523
Guido van Rossum79f25d91997-04-29 20:08:16 +0000524static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000525builtin_eval(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000526{
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000527 PyObject *cmd, *result, *tmp = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000528 PyObject *globals = Py_None, *locals = Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000529 char *str;
Tim Peters9fa96be2001-08-17 23:04:59 +0000530 PyCompilerFlags cf;
Guido van Rossum590baa41993-11-30 13:40:46 +0000531
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000532 if (!PyArg_UnpackTuple(args, "eval", 1, 3, &cmd, &globals, &locals))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000533 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000534 if (locals != Py_None && !PyMapping_Check(locals)) {
535 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000536 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000537 }
538 if (globals != Py_None && !PyDict_Check(globals)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +0000539 PyErr_SetString(PyExc_TypeError, PyMapping_Check(globals) ?
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000540 "globals must be a real dict; try eval(expr, {}, mapping)"
541 : "globals must be a dict");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000542 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000543 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000544 if (globals == Py_None) {
545 globals = PyEval_GetGlobals();
546 if (locals == Py_None)
547 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000548 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000549 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000550 locals = globals;
Tim Peters9fa96be2001-08-17 23:04:59 +0000551
Georg Brandl77c85e62005-09-15 10:46:13 +0000552 if (globals == NULL || locals == NULL) {
553 PyErr_SetString(PyExc_TypeError,
554 "eval must be given globals and locals "
555 "when called without a frame");
556 return NULL;
557 }
558
Guido van Rossum79f25d91997-04-29 20:08:16 +0000559 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
560 if (PyDict_SetItemString(globals, "__builtins__",
561 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000562 return NULL;
563 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000564
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000565 if (PyCode_Check(cmd)) {
Jeremy Hylton733c8932001-12-13 19:51:56 +0000566 if (PyCode_GetNumFree((PyCodeObject *)cmd) > 0) {
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000567 PyErr_SetString(PyExc_TypeError,
568 "code object passed to eval() may not contain free variables");
569 return NULL;
570 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000571 return PyEval_EvalCode((PyCodeObject *) cmd, globals, locals);
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000572 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000573
Marc-André Lemburgd1ba4432000-09-19 21:04:18 +0000574 if (!PyString_Check(cmd) &&
575 !PyUnicode_Check(cmd)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000576 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +0000577 "eval() arg 1 must be a string or code object");
Guido van Rossum94390a41992-08-14 15:14:30 +0000578 return NULL;
579 }
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000580 cf.cf_flags = 0;
581
582#ifdef Py_USING_UNICODE
583 if (PyUnicode_Check(cmd)) {
584 tmp = PyUnicode_AsUTF8String(cmd);
585 if (tmp == NULL)
586 return NULL;
587 cmd = tmp;
588 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
589 }
590#endif
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000591 if (PyString_AsStringAndSize(cmd, &str, NULL)) {
592 Py_XDECREF(tmp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000593 return NULL;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000594 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000595 while (*str == ' ' || *str == '\t')
596 str++;
Tim Peters9fa96be2001-08-17 23:04:59 +0000597
Tim Peters9fa96be2001-08-17 23:04:59 +0000598 (void)PyEval_MergeCompilerFlags(&cf);
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000599 result = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
600 Py_XDECREF(tmp);
601 return result;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000602}
603
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000604PyDoc_STRVAR(eval_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000605"eval(source[, globals[, locals]]) -> value\n\
606\n\
607Evaluate the source in the context of globals and locals.\n\
608The source may be a string representing a Python expression\n\
609or a code object as returned by compile().\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000610The globals must be a dictionary and locals can be any mappping,\n\
611defaulting to the current globals and locals.\n\
612If only globals is given, locals defaults to it.\n");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000613
614
Guido van Rossum79f25d91997-04-29 20:08:16 +0000615static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000616builtin_execfile(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000617{
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000618 char *filename;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000619 PyObject *globals = Py_None, *locals = Py_None;
620 PyObject *res;
Guido van Rossumb3a639e2001-09-05 13:37:47 +0000621 FILE* fp = NULL;
Tim Peters5ba58662001-07-16 02:29:45 +0000622 PyCompilerFlags cf;
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000623 int exists;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000624
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000625 if (!PyArg_ParseTuple(args, "s|O!O:execfile",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000626 &filename,
Guido van Rossum79f25d91997-04-29 20:08:16 +0000627 &PyDict_Type, &globals,
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000628 &locals))
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000629 return NULL;
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000630 if (locals != Py_None && !PyMapping_Check(locals)) {
631 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
632 return NULL;
633 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000634 if (globals == Py_None) {
635 globals = PyEval_GetGlobals();
636 if (locals == Py_None)
637 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000638 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000639 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000640 locals = globals;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000641 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
642 if (PyDict_SetItemString(globals, "__builtins__",
643 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000644 return NULL;
645 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000646
647 exists = 0;
648 /* Test for existence or directory. */
Martin v. Löwis3484a182002-03-09 12:07:51 +0000649#if defined(PLAN9)
650 {
651 Dir *d;
652
653 if ((d = dirstat(filename))!=nil) {
654 if(d->mode & DMDIR)
655 werrstr("is a directory");
656 else
657 exists = 1;
658 free(d);
659 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000660 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000661#elif defined(RISCOS)
Guido van Rossume2ae77b2001-10-24 20:42:55 +0000662 if (object_exists(filename)) {
663 if (isdir(filename))
664 errno = EISDIR;
665 else
666 exists = 1;
667 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000668#else /* standard Posix */
669 {
670 struct stat s;
671 if (stat(filename, &s) == 0) {
672 if (S_ISDIR(s.st_mode))
Andrew MacIntyreda4d6cb2004-03-29 11:53:38 +0000673# if defined(PYOS_OS2) && defined(PYCC_VACPP)
Martin v. Löwis3484a182002-03-09 12:07:51 +0000674 errno = EOS2ERR;
675# else
676 errno = EISDIR;
677# endif
678 else
679 exists = 1;
680 }
681 }
682#endif
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000683
684 if (exists) {
685 Py_BEGIN_ALLOW_THREADS
Jack Jansen7b8c7542002-04-14 20:12:41 +0000686 fp = fopen(filename, "r" PY_STDIOTEXTMODE);
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000687 Py_END_ALLOW_THREADS
688
689 if (fp == NULL) {
690 exists = 0;
691 }
692 }
693
694 if (!exists) {
Peter Schneider-Kamp4c013422002-08-27 16:58:00 +0000695 PyErr_SetFromErrnoWithFilename(PyExc_IOError, filename);
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000696 return NULL;
697 }
Tim Peters5ba58662001-07-16 02:29:45 +0000698 cf.cf_flags = 0;
699 if (PyEval_MergeCompilerFlags(&cf))
Tim Peters748b8bb2001-04-28 08:20:22 +0000700 res = PyRun_FileExFlags(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000701 locals, 1, &cf);
Tim Peters5ba58662001-07-16 02:29:45 +0000702 else
Tim Peters748b8bb2001-04-28 08:20:22 +0000703 res = PyRun_FileEx(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000704 locals, 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000705 return res;
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000706}
707
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000708PyDoc_STRVAR(execfile_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000709"execfile(filename[, globals[, locals]])\n\
710\n\
711Read and execute a Python script from a file.\n\
712The globals and locals are dictionaries, defaulting to the current\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000713globals and locals. If only globals is given, locals defaults to it.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000714
715
Guido van Rossum79f25d91997-04-29 20:08:16 +0000716static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000717builtin_getattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000718{
Guido van Rossum950ff291998-06-29 13:38:57 +0000719 PyObject *v, *result, *dflt = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000720 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000721
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000722 if (!PyArg_UnpackTuple(args, "getattr", 2, 3, &v, &name, &dflt))
Guido van Rossum33894be1992-01-27 16:53:09 +0000723 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000724#ifdef Py_USING_UNICODE
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000725 if (PyUnicode_Check(name)) {
726 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
727 if (name == NULL)
728 return NULL;
729 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000730#endif
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000731
732 if (!PyString_Check(name)) {
733 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000734 "getattr(): attribute name must be string");
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000735 return NULL;
736 }
Guido van Rossum950ff291998-06-29 13:38:57 +0000737 result = PyObject_GetAttr(v, name);
Guido van Rossumd8923572001-10-16 21:31:32 +0000738 if (result == NULL && dflt != NULL &&
739 PyErr_ExceptionMatches(PyExc_AttributeError))
740 {
Guido van Rossum950ff291998-06-29 13:38:57 +0000741 PyErr_Clear();
742 Py_INCREF(dflt);
743 result = dflt;
744 }
745 return result;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000746}
747
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000748PyDoc_STRVAR(getattr_doc,
Guido van Rossum950ff291998-06-29 13:38:57 +0000749"getattr(object, name[, default]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000750\n\
Guido van Rossum950ff291998-06-29 13:38:57 +0000751Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
752When a default argument is given, it is returned when the attribute doesn't\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000753exist; without it, an exception is raised in that case.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000754
755
Guido van Rossum79f25d91997-04-29 20:08:16 +0000756static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000757builtin_globals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +0000758{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000759 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000760
Guido van Rossum79f25d91997-04-29 20:08:16 +0000761 d = PyEval_GetGlobals();
762 Py_INCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +0000763 return d;
764}
765
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000766PyDoc_STRVAR(globals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000767"globals() -> dictionary\n\
768\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000769Return the dictionary containing the current scope's global variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000770
771
Guido van Rossum79f25d91997-04-29 20:08:16 +0000772static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000773builtin_hasattr(PyObject *self, PyObject *args)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000774{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000775 PyObject *v;
776 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000777
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000778 if (!PyArg_UnpackTuple(args, "hasattr", 2, 2, &v, &name))
Guido van Rossum9bfef441993-03-29 10:43:31 +0000779 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000780#ifdef Py_USING_UNICODE
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000781 if (PyUnicode_Check(name)) {
782 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
783 if (name == NULL)
784 return NULL;
785 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000786#endif
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000787
788 if (!PyString_Check(name)) {
789 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000790 "hasattr(): attribute name must be string");
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000791 return NULL;
792 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000793 v = PyObject_GetAttr(v, name);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000794 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000795 PyErr_Clear();
Guido van Rossum09df08a1998-05-22 00:51:39 +0000796 Py_INCREF(Py_False);
797 return Py_False;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000798 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000799 Py_DECREF(v);
Guido van Rossum09df08a1998-05-22 00:51:39 +0000800 Py_INCREF(Py_True);
801 return Py_True;
Guido van Rossum33894be1992-01-27 16:53:09 +0000802}
803
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000804PyDoc_STRVAR(hasattr_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000805"hasattr(object, name) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000806\n\
807Return whether the object has an attribute with the given name.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000808(This is done by calling getattr(object, name) and catching exceptions.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000809
810
Guido van Rossum79f25d91997-04-29 20:08:16 +0000811static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000812builtin_id(PyObject *self, PyObject *v)
Guido van Rossum5b722181993-03-30 17:46:03 +0000813{
Guido van Rossum106f2da2000-06-28 21:12:25 +0000814 return PyLong_FromVoidPtr(v);
Guido van Rossum5b722181993-03-30 17:46:03 +0000815}
816
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000817PyDoc_STRVAR(id_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000818"id(object) -> integer\n\
819\n\
820Return the identity of an object. This is guaranteed to be unique among\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000821simultaneously existing objects. (Hint: it's the object's memory address.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000822
823
Guido van Rossum79f25d91997-04-29 20:08:16 +0000824static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000825builtin_map(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000826{
827 typedef struct {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000828 PyObject *it; /* the iterator object */
829 int saw_StopIteration; /* bool: did the iterator end? */
Guido van Rossum12d12c51993-10-26 17:58:25 +0000830 } sequence;
831
Guido van Rossum79f25d91997-04-29 20:08:16 +0000832 PyObject *func, *result;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000833 sequence *seqs = NULL, *sqp;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000834 Py_ssize_t n, len;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000835 register int i, j;
836
Guido van Rossum79f25d91997-04-29 20:08:16 +0000837 n = PyTuple_Size(args);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000838 if (n < 2) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000839 PyErr_SetString(PyExc_TypeError,
840 "map() requires at least two args");
Guido van Rossum12d12c51993-10-26 17:58:25 +0000841 return NULL;
842 }
843
Guido van Rossum79f25d91997-04-29 20:08:16 +0000844 func = PyTuple_GetItem(args, 0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000845 n--;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000846
Guido van Rossumfa4ac711998-07-10 17:37:30 +0000847 if (func == Py_None && n == 1) {
848 /* map(None, S) is the same as list(S). */
849 return PySequence_List(PyTuple_GetItem(args, 1));
850 }
851
Tim Peters4e9afdc2001-05-03 23:54:49 +0000852 /* Get space for sequence descriptors. Must NULL out the iterator
853 * pointers so that jumping to Fail_2 later doesn't see trash.
854 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000855 if ((seqs = PyMem_NEW(sequence, n)) == NULL) {
856 PyErr_NoMemory();
Tim Peters4e9afdc2001-05-03 23:54:49 +0000857 return NULL;
858 }
859 for (i = 0; i < n; ++i) {
860 seqs[i].it = (PyObject*)NULL;
861 seqs[i].saw_StopIteration = 0;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000862 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000863
Tim Peters4e9afdc2001-05-03 23:54:49 +0000864 /* Do a first pass to obtain iterators for the arguments, and set len
865 * to the largest of their lengths.
Tim Peters748b8bb2001-04-28 08:20:22 +0000866 */
Tim Peters4e9afdc2001-05-03 23:54:49 +0000867 len = 0;
868 for (i = 0, sqp = seqs; i < n; ++i, ++sqp) {
869 PyObject *curseq;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000870 Py_ssize_t curlen;
Guido van Rossumad991772001-01-12 16:03:05 +0000871
Tim Peters4e9afdc2001-05-03 23:54:49 +0000872 /* Get iterator. */
873 curseq = PyTuple_GetItem(args, i+1);
874 sqp->it = PyObject_GetIter(curseq);
875 if (sqp->it == NULL) {
Guido van Rossum12d12c51993-10-26 17:58:25 +0000876 static char errmsg[] =
Tim Peters4e9afdc2001-05-03 23:54:49 +0000877 "argument %d to map() must support iteration";
Guido van Rossum15e33a41997-04-30 19:00:27 +0000878 char errbuf[sizeof(errmsg) + 25];
Jeremy Hylton518ab1c2001-11-28 20:42:20 +0000879 PyOS_snprintf(errbuf, sizeof(errbuf), errmsg, i+2);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000880 PyErr_SetString(PyExc_TypeError, errbuf);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000881 goto Fail_2;
882 }
883
Tim Peters4e9afdc2001-05-03 23:54:49 +0000884 /* Update len. */
Armin Rigof5b3e362006-02-11 21:32:43 +0000885 curlen = _PyObject_LengthHint(curseq);
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000886 if (curlen < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +0000887 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
888 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
889 goto Fail_2;
890 }
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000891 PyErr_Clear();
Tim Peters4e9afdc2001-05-03 23:54:49 +0000892 curlen = 8; /* arbitrary */
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000893 }
894 if (curlen > len)
895 len = curlen;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000896 }
897
Tim Peters4e9afdc2001-05-03 23:54:49 +0000898 /* Get space for the result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000899 if ((result = (PyObject *) PyList_New(len)) == NULL)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000900 goto Fail_2;
901
Tim Peters4e9afdc2001-05-03 23:54:49 +0000902 /* Iterate over the sequences until all have stopped. */
Guido van Rossum2d951851994-08-29 12:52:16 +0000903 for (i = 0; ; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000904 PyObject *alist, *item=NULL, *value;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000905 int numactive = 0;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000906
Guido van Rossum79f25d91997-04-29 20:08:16 +0000907 if (func == Py_None && n == 1)
Guido van Rossum32120311995-07-10 13:52:21 +0000908 alist = NULL;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000909 else if ((alist = PyTuple_New(n)) == NULL)
910 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000911
912 for (j = 0, sqp = seqs; j < n; ++j, ++sqp) {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000913 if (sqp->saw_StopIteration) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000914 Py_INCREF(Py_None);
915 item = Py_None;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000916 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000917 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000918 item = PyIter_Next(sqp->it);
919 if (item)
920 ++numactive;
921 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000922 if (PyErr_Occurred()) {
Tim Petersf4848da2001-05-05 00:14:56 +0000923 Py_XDECREF(alist);
924 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000925 }
Tim Peters4e9afdc2001-05-03 23:54:49 +0000926 Py_INCREF(Py_None);
927 item = Py_None;
928 sqp->saw_StopIteration = 1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000929 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000930 }
Tim Peters4e9afdc2001-05-03 23:54:49 +0000931 if (alist)
932 PyTuple_SET_ITEM(alist, j, item);
933 else
Guido van Rossum2d951851994-08-29 12:52:16 +0000934 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000935 }
936
Guido van Rossum32120311995-07-10 13:52:21 +0000937 if (!alist)
938 alist = item;
Guido van Rossum2d951851994-08-29 12:52:16 +0000939
Tim Peters4e9afdc2001-05-03 23:54:49 +0000940 if (numactive == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000941 Py_DECREF(alist);
Guido van Rossum2d951851994-08-29 12:52:16 +0000942 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000943 }
Guido van Rossum2d951851994-08-29 12:52:16 +0000944
Guido van Rossum79f25d91997-04-29 20:08:16 +0000945 if (func == Py_None)
Guido van Rossum32120311995-07-10 13:52:21 +0000946 value = alist;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000947 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000948 value = PyEval_CallObject(func, alist);
949 Py_DECREF(alist);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000950 if (value == NULL)
951 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000952 }
953 if (i >= len) {
Barry Warsawfa77e091999-01-28 18:49:12 +0000954 int status = PyList_Append(result, value);
Barry Warsaw21332871999-01-28 04:21:35 +0000955 Py_DECREF(value);
Barry Warsawfa77e091999-01-28 18:49:12 +0000956 if (status < 0)
957 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000958 }
Tim Peters4e9afdc2001-05-03 23:54:49 +0000959 else if (PyList_SetItem(result, i, value) < 0)
960 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000961 }
962
Guido van Rossumfa4ac711998-07-10 17:37:30 +0000963 if (i < len && PyList_SetSlice(result, i, len, NULL) < 0)
964 goto Fail_1;
965
Tim Peters4e9afdc2001-05-03 23:54:49 +0000966 goto Succeed;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000967
Guido van Rossum12d12c51993-10-26 17:58:25 +0000968Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +0000969 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000970Fail_2:
Tim Peters4e9afdc2001-05-03 23:54:49 +0000971 result = NULL;
972Succeed:
973 assert(seqs);
974 for (i = 0; i < n; ++i)
975 Py_XDECREF(seqs[i].it);
976 PyMem_DEL(seqs);
977 return result;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000978}
979
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000980PyDoc_STRVAR(map_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000981"map(function, sequence[, sequence, ...]) -> list\n\
982\n\
983Return a list of the results of applying the function to the items of\n\
984the argument sequence(s). If more than one sequence is given, the\n\
985function is called with an argument list consisting of the corresponding\n\
986item of each sequence, substituting None for missing values when not all\n\
987sequences have the same length. If the function is None, return a list of\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000988the items of the sequence (or a list of tuples if more than one sequence).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000989
990
Guido van Rossum79f25d91997-04-29 20:08:16 +0000991static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000992builtin_setattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000993{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000994 PyObject *v;
995 PyObject *name;
996 PyObject *value;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000997
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000998 if (!PyArg_UnpackTuple(args, "setattr", 3, 3, &v, &name, &value))
Guido van Rossum33894be1992-01-27 16:53:09 +0000999 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001000 if (PyObject_SetAttr(v, name, value) != 0)
Guido van Rossum33894be1992-01-27 16:53:09 +00001001 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001002 Py_INCREF(Py_None);
1003 return Py_None;
Guido van Rossum33894be1992-01-27 16:53:09 +00001004}
1005
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001006PyDoc_STRVAR(setattr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001007"setattr(object, name, value)\n\
1008\n\
1009Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001010``x.y = v''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001011
1012
Guido van Rossum79f25d91997-04-29 20:08:16 +00001013static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001014builtin_delattr(PyObject *self, PyObject *args)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001015{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001016 PyObject *v;
1017 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001018
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001019 if (!PyArg_UnpackTuple(args, "delattr", 2, 2, &v, &name))
Guido van Rossum14144fc1994-08-29 12:53:40 +00001020 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001021 if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001022 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001023 Py_INCREF(Py_None);
1024 return Py_None;
Guido van Rossum14144fc1994-08-29 12:53:40 +00001025}
1026
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001027PyDoc_STRVAR(delattr_doc,
Guido van Rossumdf12a591998-11-23 22:13:04 +00001028"delattr(object, name)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001029\n\
1030Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001031``del x.y''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001032
1033
Guido van Rossum79f25d91997-04-29 20:08:16 +00001034static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001035builtin_hash(PyObject *self, PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00001036{
Guido van Rossum9bfef441993-03-29 10:43:31 +00001037 long x;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001038
Guido van Rossum79f25d91997-04-29 20:08:16 +00001039 x = PyObject_Hash(v);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001040 if (x == -1)
1041 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001042 return PyInt_FromLong(x);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001043}
1044
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001045PyDoc_STRVAR(hash_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001046"hash(object) -> integer\n\
1047\n\
1048Return a hash value for the object. Two objects with the same value have\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001049the same hash value. The reverse is not necessarily true, but likely.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001050
1051
Guido van Rossum79f25d91997-04-29 20:08:16 +00001052static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001053builtin_hex(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001054{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001055 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001056 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001057
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001058 if ((nb = v->ob_type->tp_as_number) == NULL ||
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001059 nb->nb_hex == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001060 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001061 "hex() argument can't be converted to hex");
1062 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001063 }
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001064 res = (*nb->nb_hex)(v);
1065 if (res && !PyString_Check(res)) {
1066 PyErr_Format(PyExc_TypeError,
1067 "__hex__ returned non-string (type %.200s)",
1068 res->ob_type->tp_name);
1069 Py_DECREF(res);
1070 return NULL;
1071 }
1072 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001073}
1074
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001075PyDoc_STRVAR(hex_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001076"hex(number) -> string\n\
1077\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001078Return the hexadecimal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001079
1080
Tim Petersdbd9ba62000-07-09 03:09:57 +00001081static PyObject *builtin_raw_input(PyObject *, PyObject *);
Guido van Rossum3165fe61992-09-25 21:59:05 +00001082
Guido van Rossum79f25d91997-04-29 20:08:16 +00001083static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001084builtin_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001085{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001086 PyObject *line;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001087 char *str;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001088 PyObject *res;
1089 PyObject *globals, *locals;
Hye-Shik Changff83c2b2004-02-02 13:39:01 +00001090 PyCompilerFlags cf;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001091
1092 line = builtin_raw_input(self, args);
Guido van Rossum3165fe61992-09-25 21:59:05 +00001093 if (line == NULL)
1094 return line;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001095 if (!PyArg_Parse(line, "s;embedded '\\0' in input line", &str))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001096 return NULL;
1097 while (*str == ' ' || *str == '\t')
1098 str++;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001099 globals = PyEval_GetGlobals();
1100 locals = PyEval_GetLocals();
1101 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
1102 if (PyDict_SetItemString(globals, "__builtins__",
1103 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +00001104 return NULL;
1105 }
Hye-Shik Changff83c2b2004-02-02 13:39:01 +00001106 cf.cf_flags = 0;
1107 PyEval_MergeCompilerFlags(&cf);
1108 res = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001109 Py_DECREF(line);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001110 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001111}
1112
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001113PyDoc_STRVAR(input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001114"input([prompt]) -> value\n\
1115\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001116Equivalent to eval(raw_input(prompt)).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001117
1118
Guido van Rossume8811f81997-02-14 15:48:05 +00001119static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001120builtin_intern(PyObject *self, PyObject *args)
Guido van Rossume8811f81997-02-14 15:48:05 +00001121{
1122 PyObject *s;
Guido van Rossum43713e52000-02-29 13:59:29 +00001123 if (!PyArg_ParseTuple(args, "S:intern", &s))
Guido van Rossume8811f81997-02-14 15:48:05 +00001124 return NULL;
Jeremy Hylton4c989dd2004-08-07 19:20:05 +00001125 if (!PyString_CheckExact(s)) {
1126 PyErr_SetString(PyExc_TypeError,
1127 "can't intern subclass of string");
1128 return NULL;
1129 }
Guido van Rossume8811f81997-02-14 15:48:05 +00001130 Py_INCREF(s);
1131 PyString_InternInPlace(&s);
1132 return s;
1133}
1134
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001135PyDoc_STRVAR(intern_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001136"intern(string) -> string\n\
1137\n\
1138``Intern'' the given string. This enters the string in the (global)\n\
1139table of interned strings whose purpose is to speed up dictionary lookups.\n\
1140Return the string itself or the previously interned string object with the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001141same value.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001142
1143
Guido van Rossum79f25d91997-04-29 20:08:16 +00001144static PyObject *
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001145builtin_iter(PyObject *self, PyObject *args)
1146{
1147 PyObject *v, *w = NULL;
1148
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001149 if (!PyArg_UnpackTuple(args, "iter", 1, 2, &v, &w))
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001150 return NULL;
1151 if (w == NULL)
1152 return PyObject_GetIter(v);
1153 if (!PyCallable_Check(v)) {
1154 PyErr_SetString(PyExc_TypeError,
1155 "iter(v, w): v must be callable");
1156 return NULL;
1157 }
1158 return PyCallIter_New(v, w);
1159}
1160
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001161PyDoc_STRVAR(iter_doc,
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001162"iter(collection) -> iterator\n\
1163iter(callable, sentinel) -> iterator\n\
1164\n\
1165Get an iterator from an object. In the first form, the argument must\n\
1166supply its own iterator, or be a sequence.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001167In the second form, the callable is called until it returns the sentinel.");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001168
1169
1170static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001171builtin_len(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001172{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001173 Py_ssize_t res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001174
Jeremy Hylton03657cf2000-07-12 13:05:33 +00001175 res = PyObject_Size(v);
Guido van Rossum8ea9f4d1998-06-29 22:26:50 +00001176 if (res < 0 && PyErr_Occurred())
1177 return NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001178 return PyInt_FromSsize_t(res);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001179}
1180
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001181PyDoc_STRVAR(len_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001182"len(object) -> integer\n\
1183\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001184Return the number of items of a sequence or mapping.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001185
1186
Guido van Rossum79f25d91997-04-29 20:08:16 +00001187static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001188builtin_locals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +00001189{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001190 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001191
Guido van Rossum79f25d91997-04-29 20:08:16 +00001192 d = PyEval_GetLocals();
1193 Py_INCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +00001194 return d;
1195}
1196
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001197PyDoc_STRVAR(locals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001198"locals() -> dictionary\n\
1199\n\
Raymond Hettinger69bf8f32003-01-04 02:16:22 +00001200Update and return a dictionary containing the current scope's local variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001201
1202
Guido van Rossum79f25d91997-04-29 20:08:16 +00001203static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001204min_max(PyObject *args, PyObject *kwds, int op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001205{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001206 PyObject *v, *it, *item, *val, *maxitem, *maxval, *keyfunc=NULL;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001207 const char *name = op == Py_LT ? "min" : "max";
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001208
Guido van Rossum79f25d91997-04-29 20:08:16 +00001209 if (PyTuple_Size(args) > 1)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001210 v = args;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001211 else if (!PyArg_UnpackTuple(args, (char *)name, 1, 1, &v))
Guido van Rossum3f5da241990-12-20 15:06:42 +00001212 return NULL;
Tim Peters67d687a2002-04-29 21:27:32 +00001213
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001214 if (kwds != NULL && PyDict_Check(kwds) && PyDict_Size(kwds)) {
1215 keyfunc = PyDict_GetItemString(kwds, "key");
1216 if (PyDict_Size(kwds)!=1 || keyfunc == NULL) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001217 PyErr_Format(PyExc_TypeError,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001218 "%s() got an unexpected keyword argument", name);
1219 return NULL;
1220 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001221 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001222
Tim Petersc3074532001-05-03 07:00:32 +00001223 it = PyObject_GetIter(v);
1224 if (it == NULL)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001225 return NULL;
Tim Petersc3074532001-05-03 07:00:32 +00001226
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001227 maxitem = NULL; /* the result */
1228 maxval = NULL; /* the value associated with the result */
Brett Cannon9e635cf2004-12-07 00:25:35 +00001229 while (( item = PyIter_Next(it) )) {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001230 /* get the value from the key function */
1231 if (keyfunc != NULL) {
1232 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1233 if (val == NULL)
1234 goto Fail_it_item;
1235 }
1236 /* no key function; the value is the item */
1237 else {
1238 val = item;
1239 Py_INCREF(val);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001240 }
Tim Petersc3074532001-05-03 07:00:32 +00001241
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001242 /* maximum value and item are unset; set them */
1243 if (maxval == NULL) {
1244 maxitem = item;
1245 maxval = val;
1246 }
1247 /* maximum value and item are set; update them as necessary */
Guido van Rossum2d951851994-08-29 12:52:16 +00001248 else {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001249 int cmp = PyObject_RichCompareBool(val, maxval, op);
1250 if (cmp < 0)
1251 goto Fail_it_item_and_val;
1252 else if (cmp > 0) {
1253 Py_DECREF(maxval);
1254 Py_DECREF(maxitem);
1255 maxval = val;
1256 maxitem = item;
Guido van Rossum53451b32001-01-17 15:47:24 +00001257 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001258 else {
1259 Py_DECREF(item);
1260 Py_DECREF(val);
Guido van Rossumc8b6df91997-05-23 00:06:51 +00001261 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001262 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001263 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001264 if (PyErr_Occurred())
1265 goto Fail_it;
1266 if (maxval == NULL) {
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001267 PyErr_Format(PyExc_ValueError,
1268 "%s() arg is an empty sequence", name);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001269 assert(maxitem == NULL);
1270 }
1271 else
1272 Py_DECREF(maxval);
Tim Petersc3074532001-05-03 07:00:32 +00001273 Py_DECREF(it);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001274 return maxitem;
1275
1276Fail_it_item_and_val:
1277 Py_DECREF(val);
1278Fail_it_item:
1279 Py_DECREF(item);
1280Fail_it:
1281 Py_XDECREF(maxval);
1282 Py_XDECREF(maxitem);
1283 Py_DECREF(it);
1284 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001285}
1286
Guido van Rossum79f25d91997-04-29 20:08:16 +00001287static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001288builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001289{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001290 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001291}
1292
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001293PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001294"min(iterable[, key=func]) -> value\n\
1295min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001296\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001297With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001298With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001299
1300
Guido van Rossum79f25d91997-04-29 20:08:16 +00001301static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001302builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001303{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001304 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001305}
1306
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001307PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001308"max(iterable[, key=func]) -> value\n\
1309max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001310\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001311With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001312With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001313
1314
Guido van Rossum79f25d91997-04-29 20:08:16 +00001315static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001316builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001317{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001318 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001319 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001320
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001321 if (v == NULL || (nb = v->ob_type->tp_as_number) == NULL ||
1322 nb->nb_oct == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001323 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001324 "oct() argument can't be converted to oct");
1325 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001326 }
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001327 res = (*nb->nb_oct)(v);
1328 if (res && !PyString_Check(res)) {
1329 PyErr_Format(PyExc_TypeError,
1330 "__oct__ returned non-string (type %.200s)",
1331 res->ob_type->tp_name);
1332 Py_DECREF(res);
1333 return NULL;
1334 }
1335 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001336}
1337
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001338PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001339"oct(number) -> string\n\
1340\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001341Return the octal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001342
1343
Guido van Rossum79f25d91997-04-29 20:08:16 +00001344static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001345builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001346{
Guido van Rossum09095f32000-03-10 23:00:52 +00001347 long ord;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001348 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001349
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001350 if (PyString_Check(obj)) {
1351 size = PyString_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001352 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001353 ord = (long)((unsigned char)*PyString_AS_STRING(obj));
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001354 return PyInt_FromLong(ord);
1355 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001356#ifdef Py_USING_UNICODE
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001357 } else if (PyUnicode_Check(obj)) {
1358 size = PyUnicode_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001359 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001360 ord = (long)*PyUnicode_AS_UNICODE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001361 return PyInt_FromLong(ord);
1362 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001363#endif
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001364 } else {
1365 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001366 "ord() expected string of length 1, but " \
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001367 "%.200s found", obj->ob_type->tp_name);
Guido van Rossum09095f32000-03-10 23:00:52 +00001368 return NULL;
1369 }
1370
Guido van Rossumad991772001-01-12 16:03:05 +00001371 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001372 "ord() expected a character, "
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001373 "but string of length %zd found",
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001374 size);
1375 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001376}
1377
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001378PyDoc_STRVAR(ord_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001379"ord(c) -> integer\n\
1380\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001381Return the integer ordinal of a one-character string.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001382
1383
Guido van Rossum79f25d91997-04-29 20:08:16 +00001384static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001385builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001386{
Guido van Rossum09df08a1998-05-22 00:51:39 +00001387 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001388
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001389 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001390 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +00001391 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001392}
1393
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001394PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001395"pow(x, y[, z]) -> number\n\
1396\n\
1397With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001398equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001399
1400
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001401
1402/* Return number of items in range (lo, hi, step), when arguments are
1403 * PyInt or PyLong objects. step > 0 required. Return a value < 0 if
1404 * & only if the true value is too large to fit in a signed long.
1405 * Arguments MUST return 1 with either PyInt_Check() or
1406 * PyLong_Check(). Return -1 when there is an error.
1407 */
1408static long
1409get_len_of_range_longs(PyObject *lo, PyObject *hi, PyObject *step)
1410{
1411 /* -------------------------------------------------------------
1412 Algorithm is equal to that of get_len_of_range(), but it operates
1413 on PyObjects (which are assumed to be PyLong or PyInt objects).
1414 ---------------------------------------------------------------*/
1415 long n;
1416 PyObject *diff = NULL;
1417 PyObject *one = NULL;
1418 PyObject *tmp1 = NULL, *tmp2 = NULL, *tmp3 = NULL;
1419 /* holds sub-expression evaluations */
1420
1421 /* if (lo >= hi), return length of 0. */
1422 if (PyObject_Compare(lo, hi) >= 0)
1423 return 0;
1424
1425 if ((one = PyLong_FromLong(1L)) == NULL)
1426 goto Fail;
1427
1428 if ((tmp1 = PyNumber_Subtract(hi, lo)) == NULL)
1429 goto Fail;
1430
1431 if ((diff = PyNumber_Subtract(tmp1, one)) == NULL)
1432 goto Fail;
1433
1434 if ((tmp2 = PyNumber_FloorDivide(diff, step)) == NULL)
1435 goto Fail;
1436
1437 if ((tmp3 = PyNumber_Add(tmp2, one)) == NULL)
1438 goto Fail;
1439
1440 n = PyLong_AsLong(tmp3);
1441 if (PyErr_Occurred()) { /* Check for Overflow */
1442 PyErr_Clear();
1443 goto Fail;
1444 }
1445
1446 Py_DECREF(tmp3);
1447 Py_DECREF(tmp2);
1448 Py_DECREF(diff);
1449 Py_DECREF(tmp1);
1450 Py_DECREF(one);
1451 return n;
1452
1453 Fail:
1454 Py_XDECREF(tmp3);
1455 Py_XDECREF(tmp2);
1456 Py_XDECREF(diff);
1457 Py_XDECREF(tmp1);
1458 Py_XDECREF(one);
1459 return -1;
1460}
1461
1462/* An extension of builtin_range() that handles the case when PyLong
1463 * arguments are given. */
1464static PyObject *
1465handle_range_longs(PyObject *self, PyObject *args)
1466{
1467 PyObject *ilow;
Tim Peters874e1f72003-04-13 22:13:08 +00001468 PyObject *ihigh = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001469 PyObject *istep = NULL;
Tim Peters874e1f72003-04-13 22:13:08 +00001470
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001471 PyObject *curnum = NULL;
1472 PyObject *v = NULL;
1473 long bign;
1474 int i, n;
1475 int cmp_result;
1476
Tim Peters874e1f72003-04-13 22:13:08 +00001477 PyObject *zero = PyLong_FromLong(0);
1478
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001479 if (zero == NULL)
1480 return NULL;
1481
Tim Peters874e1f72003-04-13 22:13:08 +00001482 if (!PyArg_UnpackTuple(args, "range", 1, 3, &ilow, &ihigh, &istep)) {
1483 Py_DECREF(zero);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001484 return NULL;
1485 }
1486
Tim Peters874e1f72003-04-13 22:13:08 +00001487 /* Figure out which way we were called, supply defaults, and be
1488 * sure to incref everything so that the decrefs at the end
1489 * are correct.
1490 */
1491 assert(ilow != NULL);
1492 if (ihigh == NULL) {
1493 /* only 1 arg -- it's the upper limit */
1494 ihigh = ilow;
1495 ilow = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001496 }
Tim Peters874e1f72003-04-13 22:13:08 +00001497 assert(ihigh != NULL);
1498 Py_INCREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001499
Tim Peters874e1f72003-04-13 22:13:08 +00001500 /* ihigh correct now; do ilow */
1501 if (ilow == NULL)
1502 ilow = zero;
1503 Py_INCREF(ilow);
1504
1505 /* ilow and ihigh correct now; do istep */
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001506 if (istep == NULL) {
1507 istep = PyLong_FromLong(1L);
1508 if (istep == NULL)
1509 goto Fail;
1510 }
1511 else {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001512 Py_INCREF(istep);
1513 }
1514
Tim Peters874e1f72003-04-13 22:13:08 +00001515 if (!PyInt_Check(ilow) && !PyLong_Check(ilow)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001516 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001517 "range() integer start argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001518 ilow->ob_type->tp_name);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001519 goto Fail;
1520 }
1521
Tim Peters874e1f72003-04-13 22:13:08 +00001522 if (!PyInt_Check(ihigh) && !PyLong_Check(ihigh)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001523 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001524 "range() integer end argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001525 ihigh->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001526 goto Fail;
1527 }
1528
1529 if (!PyInt_Check(istep) && !PyLong_Check(istep)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001530 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001531 "range() integer step argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001532 istep->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001533 goto Fail;
1534 }
1535
1536 if (PyObject_Cmp(istep, zero, &cmp_result) == -1)
1537 goto Fail;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001538 if (cmp_result == 0) {
1539 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001540 "range() step argument must not be zero");
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001541 goto Fail;
1542 }
1543
1544 if (cmp_result > 0)
1545 bign = get_len_of_range_longs(ilow, ihigh, istep);
1546 else {
1547 PyObject *neg_istep = PyNumber_Negative(istep);
1548 if (neg_istep == NULL)
1549 goto Fail;
1550 bign = get_len_of_range_longs(ihigh, ilow, neg_istep);
1551 Py_DECREF(neg_istep);
1552 }
1553
1554 n = (int)bign;
1555 if (bign < 0 || (long)n != bign) {
1556 PyErr_SetString(PyExc_OverflowError,
1557 "range() result has too many items");
1558 goto Fail;
1559 }
1560
1561 v = PyList_New(n);
1562 if (v == NULL)
1563 goto Fail;
1564
1565 curnum = ilow;
1566 Py_INCREF(curnum);
1567
1568 for (i = 0; i < n; i++) {
1569 PyObject *w = PyNumber_Long(curnum);
1570 PyObject *tmp_num;
1571 if (w == NULL)
1572 goto Fail;
1573
1574 PyList_SET_ITEM(v, i, w);
1575
1576 tmp_num = PyNumber_Add(curnum, istep);
1577 if (tmp_num == NULL)
1578 goto Fail;
1579
1580 Py_DECREF(curnum);
1581 curnum = tmp_num;
1582 }
Tim Peters874e1f72003-04-13 22:13:08 +00001583 Py_DECREF(ilow);
1584 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001585 Py_DECREF(istep);
1586 Py_DECREF(zero);
Tim Peters874e1f72003-04-13 22:13:08 +00001587 Py_DECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001588 return v;
1589
1590 Fail:
Tim Peters874e1f72003-04-13 22:13:08 +00001591 Py_DECREF(ilow);
1592 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001593 Py_XDECREF(istep);
Tim Peters874e1f72003-04-13 22:13:08 +00001594 Py_DECREF(zero);
1595 Py_XDECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001596 Py_XDECREF(v);
1597 return NULL;
1598}
1599
Guido van Rossum124eff01999-02-23 16:11:01 +00001600/* Return number of items in range/xrange (lo, hi, step). step > 0
1601 * required. Return a value < 0 if & only if the true value is too
1602 * large to fit in a signed long.
1603 */
1604static long
Thomas Wouterse28c2962000-07-23 22:21:32 +00001605get_len_of_range(long lo, long hi, long step)
Guido van Rossum124eff01999-02-23 16:11:01 +00001606{
1607 /* -------------------------------------------------------------
1608 If lo >= hi, the range is empty.
1609 Else if n values are in the range, the last one is
1610 lo + (n-1)*step, which must be <= hi-1. Rearranging,
1611 n <= (hi - lo - 1)/step + 1, so taking the floor of the RHS gives
1612 the proper value. Since lo < hi in this case, hi-lo-1 >= 0, so
1613 the RHS is non-negative and so truncation is the same as the
1614 floor. Letting M be the largest positive long, the worst case
1615 for the RHS numerator is hi=M, lo=-M-1, and then
1616 hi-lo-1 = M-(-M-1)-1 = 2*M. Therefore unsigned long has enough
1617 precision to compute the RHS exactly.
1618 ---------------------------------------------------------------*/
1619 long n = 0;
1620 if (lo < hi) {
1621 unsigned long uhi = (unsigned long)hi;
1622 unsigned long ulo = (unsigned long)lo;
1623 unsigned long diff = uhi - ulo - 1;
1624 n = (long)(diff / (unsigned long)step + 1);
1625 }
1626 return n;
1627}
1628
Guido van Rossum79f25d91997-04-29 20:08:16 +00001629static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001630builtin_range(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001631{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001632 long ilow = 0, ihigh = 0, istep = 1;
Guido van Rossum124eff01999-02-23 16:11:01 +00001633 long bign;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001634 int i, n;
Guido van Rossum124eff01999-02-23 16:11:01 +00001635
Guido van Rossum79f25d91997-04-29 20:08:16 +00001636 PyObject *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001637
Guido van Rossum79f25d91997-04-29 20:08:16 +00001638 if (PyTuple_Size(args) <= 1) {
1639 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001640 "l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001641 &ihigh)) {
1642 PyErr_Clear();
1643 return handle_range_longs(self, args);
1644 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001645 }
1646 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001647 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001648 "ll|l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001649 &ilow, &ihigh, &istep)) {
1650 PyErr_Clear();
1651 return handle_range_longs(self, args);
1652 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001653 }
1654 if (istep == 0) {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001655 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001656 "range() step argument must not be zero");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001657 return NULL;
1658 }
Guido van Rossum124eff01999-02-23 16:11:01 +00001659 if (istep > 0)
1660 bign = get_len_of_range(ilow, ihigh, istep);
1661 else
1662 bign = get_len_of_range(ihigh, ilow, -istep);
1663 n = (int)bign;
1664 if (bign < 0 || (long)n != bign) {
Guido van Rossume23cde21999-01-12 05:07:47 +00001665 PyErr_SetString(PyExc_OverflowError,
Fred Drake661ea262000-10-24 19:57:45 +00001666 "range() result has too many items");
Guido van Rossume23cde21999-01-12 05:07:47 +00001667 return NULL;
1668 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001669 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001670 if (v == NULL)
1671 return NULL;
1672 for (i = 0; i < n; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001673 PyObject *w = PyInt_FromLong(ilow);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001674 if (w == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001675 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001676 return NULL;
1677 }
Guido van Rossuma937d141998-04-24 18:22:02 +00001678 PyList_SET_ITEM(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001679 ilow += istep;
1680 }
1681 return v;
1682}
1683
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001684PyDoc_STRVAR(range_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001685"range([start,] stop[, step]) -> list of integers\n\
1686\n\
1687Return a list containing an arithmetic progression of integers.\n\
1688range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.\n\
1689When step is given, it specifies the increment (or decrement).\n\
1690For example, range(4) returns [0, 1, 2, 3]. The end point is omitted!\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001691These are exactly the valid indices for a list of 4 elements.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001692
1693
Guido van Rossum79f25d91997-04-29 20:08:16 +00001694static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001695builtin_raw_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001696{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001697 PyObject *v = NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001698 PyObject *fin = PySys_GetObject("stdin");
1699 PyObject *fout = PySys_GetObject("stdout");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001700
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001701 if (!PyArg_UnpackTuple(args, "[raw_]input", 0, 1, &v))
Guido van Rossum3165fe61992-09-25 21:59:05 +00001702 return NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001703
1704 if (fin == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001705 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdin");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001706 return NULL;
1707 }
1708 if (fout == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001709 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdout");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001710 return NULL;
1711 }
1712 if (PyFile_SoftSpace(fout, 0)) {
1713 if (PyFile_WriteString(" ", fout) != 0)
1714 return NULL;
1715 }
Michael W. Hudson52db5192004-08-02 13:21:09 +00001716 if (PyFile_Check(fin) && PyFile_Check(fout)
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001717 && isatty(fileno(PyFile_AsFile(fin)))
1718 && isatty(fileno(PyFile_AsFile(fout)))) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001719 PyObject *po;
Guido van Rossum872537c1995-07-07 22:43:42 +00001720 char *prompt;
1721 char *s;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001722 PyObject *result;
Guido van Rossum872537c1995-07-07 22:43:42 +00001723 if (v != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001724 po = PyObject_Str(v);
Guido van Rossum872537c1995-07-07 22:43:42 +00001725 if (po == NULL)
1726 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001727 prompt = PyString_AsString(po);
Guido van Rossumd9b52081998-06-26 18:25:38 +00001728 if (prompt == NULL)
1729 return NULL;
Guido van Rossum872537c1995-07-07 22:43:42 +00001730 }
1731 else {
1732 po = NULL;
1733 prompt = "";
1734 }
Michael W. Hudson52db5192004-08-02 13:21:09 +00001735 s = PyOS_Readline(PyFile_AsFile(fin), PyFile_AsFile(fout),
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001736 prompt);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001737 Py_XDECREF(po);
Guido van Rossum872537c1995-07-07 22:43:42 +00001738 if (s == NULL) {
Michael W. Hudson30ea2f22004-07-07 17:44:12 +00001739 if (!PyErr_Occurred())
1740 PyErr_SetNone(PyExc_KeyboardInterrupt);
Guido van Rossum872537c1995-07-07 22:43:42 +00001741 return NULL;
1742 }
1743 if (*s == '\0') {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001744 PyErr_SetNone(PyExc_EOFError);
Guido van Rossum872537c1995-07-07 22:43:42 +00001745 result = NULL;
1746 }
1747 else { /* strip trailing '\n' */
Guido van Rossum106f2da2000-06-28 21:12:25 +00001748 size_t len = strlen(s);
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00001749 if (len > PY_SSIZE_T_MAX) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001750 PyErr_SetString(PyExc_OverflowError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001751 "[raw_]input: input too long");
Guido van Rossum106f2da2000-06-28 21:12:25 +00001752 result = NULL;
1753 }
1754 else {
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00001755 result = PyString_FromStringAndSize(s, len-1);
Guido van Rossum106f2da2000-06-28 21:12:25 +00001756 }
Guido van Rossum872537c1995-07-07 22:43:42 +00001757 }
Guido van Rossumb18618d2000-05-03 23:44:39 +00001758 PyMem_FREE(s);
Guido van Rossum872537c1995-07-07 22:43:42 +00001759 return result;
1760 }
Guido van Rossum90933611991-06-07 16:10:43 +00001761 if (v != NULL) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001762 if (PyFile_WriteObject(v, fout, Py_PRINT_RAW) != 0)
Guido van Rossum90933611991-06-07 16:10:43 +00001763 return NULL;
1764 }
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001765 return PyFile_GetLine(fin, -1);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001766}
1767
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001768PyDoc_STRVAR(raw_input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001769"raw_input([prompt]) -> string\n\
1770\n\
1771Read a string from standard input. The trailing newline is stripped.\n\
1772If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
1773On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001774is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001775
1776
Guido van Rossum79f25d91997-04-29 20:08:16 +00001777static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001778builtin_reduce(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +00001779{
Tim Peters15d81ef2001-05-04 04:39:21 +00001780 PyObject *seq, *func, *result = NULL, *it;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001781
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001782 if (!PyArg_UnpackTuple(args, "reduce", 2, 3, &func, &seq, &result))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001783 return NULL;
1784 if (result != NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00001785 Py_INCREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001786
Tim Peters15d81ef2001-05-04 04:39:21 +00001787 it = PyObject_GetIter(seq);
1788 if (it == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001789 PyErr_SetString(PyExc_TypeError,
Tim Peters15d81ef2001-05-04 04:39:21 +00001790 "reduce() arg 2 must support iteration");
1791 Py_XDECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001792 return NULL;
1793 }
1794
Guido van Rossum79f25d91997-04-29 20:08:16 +00001795 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001796 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001797
Tim Peters15d81ef2001-05-04 04:39:21 +00001798 for (;;) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001799 PyObject *op2;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001800
1801 if (args->ob_refcnt > 1) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001802 Py_DECREF(args);
1803 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001804 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001805 }
1806
Tim Peters15d81ef2001-05-04 04:39:21 +00001807 op2 = PyIter_Next(it);
1808 if (op2 == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +00001809 if (PyErr_Occurred())
1810 goto Fail;
1811 break;
Guido van Rossum2d951851994-08-29 12:52:16 +00001812 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001813
Guido van Rossum2d951851994-08-29 12:52:16 +00001814 if (result == NULL)
1815 result = op2;
1816 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001817 PyTuple_SetItem(args, 0, result);
1818 PyTuple_SetItem(args, 1, op2);
1819 if ((result = PyEval_CallObject(func, args)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001820 goto Fail;
1821 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001822 }
1823
Guido van Rossum79f25d91997-04-29 20:08:16 +00001824 Py_DECREF(args);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001825
Guido van Rossum2d951851994-08-29 12:52:16 +00001826 if (result == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00001827 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +00001828 "reduce() of empty sequence with no initial value");
Guido van Rossum2d951851994-08-29 12:52:16 +00001829
Tim Peters15d81ef2001-05-04 04:39:21 +00001830 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001831 return result;
1832
Guido van Rossum2d951851994-08-29 12:52:16 +00001833Fail:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001834 Py_XDECREF(args);
1835 Py_XDECREF(result);
Tim Peters15d81ef2001-05-04 04:39:21 +00001836 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001837 return NULL;
1838}
1839
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001840PyDoc_STRVAR(reduce_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001841"reduce(function, sequence[, initial]) -> value\n\
1842\n\
1843Apply a function of two arguments cumulatively to the items of a sequence,\n\
1844from left to right, so as to reduce the sequence to a single value.\n\
1845For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates\n\
1846((((1+2)+3)+4)+5). If initial is present, it is placed before the items\n\
1847of the sequence in the calculation, and serves as a default when the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001848sequence is empty.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001849
1850
Guido van Rossum79f25d91997-04-29 20:08:16 +00001851static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001852builtin_reload(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001853{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001854 return PyImport_ReloadModule(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001855}
1856
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001857PyDoc_STRVAR(reload_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001858"reload(module) -> module\n\
1859\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001860Reload the module. The module must have been successfully imported before.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001861
1862
Guido van Rossum79f25d91997-04-29 20:08:16 +00001863static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001864builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00001865{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001866 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00001867}
1868
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001869PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001870"repr(object) -> string\n\
1871\n\
1872Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001873For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001874
1875
Guido van Rossum79f25d91997-04-29 20:08:16 +00001876static PyObject *
Georg Brandlccadf842006-03-31 18:54:53 +00001877builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001878{
Georg Brandlccadf842006-03-31 18:54:53 +00001879 double number;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001880 double f;
1881 int ndigits = 0;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001882 int i;
Georg Brandlccadf842006-03-31 18:54:53 +00001883 static char *kwlist[] = {"number", "ndigits", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001884
Georg Brandlccadf842006-03-31 18:54:53 +00001885 if (!PyArg_ParseTupleAndKeywords(args, kwds, "d|i:round",
1886 kwlist, &number, &ndigits))
1887 return NULL;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001888 f = 1.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001889 i = abs(ndigits);
1890 while (--i >= 0)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001891 f = f*10.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001892 if (ndigits < 0)
Georg Brandlccadf842006-03-31 18:54:53 +00001893 number /= f;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001894 else
Georg Brandlccadf842006-03-31 18:54:53 +00001895 number *= f;
1896 if (number >= 0.0)
1897 number = floor(number + 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001898 else
Georg Brandlccadf842006-03-31 18:54:53 +00001899 number = ceil(number - 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001900 if (ndigits < 0)
Georg Brandlccadf842006-03-31 18:54:53 +00001901 number *= f;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001902 else
Georg Brandlccadf842006-03-31 18:54:53 +00001903 number /= f;
1904 return PyFloat_FromDouble(number);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001905}
1906
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001907PyDoc_STRVAR(round_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001908"round(number[, ndigits]) -> floating point number\n\
1909\n\
1910Round a number to a given precision in decimal digits (default 0 digits).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001911This always returns a floating point number. Precision may be negative.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001912
Raymond Hettinger64958a12003-12-17 20:43:33 +00001913static PyObject *
1914builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
1915{
1916 PyObject *newlist, *v, *seq, *compare=NULL, *keyfunc=NULL, *newargs;
1917 PyObject *callable;
Martin v. Löwis15e62742006-02-27 16:46:16 +00001918 static char *kwlist[] = {"iterable", "cmp", "key", "reverse", 0};
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001919 int reverse;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001920
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001921 /* args 1-4 should match listsort in Objects/listobject.c */
Armin Rigo71d7e702005-09-20 18:13:03 +00001922 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|OOi:sorted",
1923 kwlist, &seq, &compare, &keyfunc, &reverse))
1924 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001925
1926 newlist = PySequence_List(seq);
1927 if (newlist == NULL)
1928 return NULL;
1929
1930 callable = PyObject_GetAttrString(newlist, "sort");
1931 if (callable == NULL) {
1932 Py_DECREF(newlist);
1933 return NULL;
1934 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001935
Raymond Hettinger64958a12003-12-17 20:43:33 +00001936 newargs = PyTuple_GetSlice(args, 1, 4);
1937 if (newargs == NULL) {
1938 Py_DECREF(newlist);
1939 Py_DECREF(callable);
1940 return NULL;
1941 }
1942
1943 v = PyObject_Call(callable, newargs, kwds);
1944 Py_DECREF(newargs);
1945 Py_DECREF(callable);
1946 if (v == NULL) {
1947 Py_DECREF(newlist);
1948 return NULL;
1949 }
1950 Py_DECREF(v);
1951 return newlist;
1952}
1953
1954PyDoc_STRVAR(sorted_doc,
1955"sorted(iterable, cmp=None, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001956
Guido van Rossum79f25d91997-04-29 20:08:16 +00001957static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001958builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00001959{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001960 PyObject *v = NULL;
1961 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001962
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001963 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001964 return NULL;
Guido van Rossum2d951851994-08-29 12:52:16 +00001965 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001966 d = PyEval_GetLocals();
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001967 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001968 if (!PyErr_Occurred())
1969 PyErr_SetString(PyExc_SystemError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001970 "vars(): no locals!?");
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001971 }
1972 else
Guido van Rossum79f25d91997-04-29 20:08:16 +00001973 Py_INCREF(d);
Guido van Rossum2d951851994-08-29 12:52:16 +00001974 }
1975 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001976 d = PyObject_GetAttrString(v, "__dict__");
Guido van Rossum2d951851994-08-29 12:52:16 +00001977 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001978 PyErr_SetString(PyExc_TypeError,
Guido van Rossum2d951851994-08-29 12:52:16 +00001979 "vars() argument must have __dict__ attribute");
1980 return NULL;
1981 }
1982 }
1983 return d;
1984}
1985
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001986PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001987"vars([object]) -> dictionary\n\
1988\n\
1989Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001990With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001991
Alex Martellia70b1912003-04-22 08:12:33 +00001992
1993static PyObject*
1994builtin_sum(PyObject *self, PyObject *args)
1995{
1996 PyObject *seq;
1997 PyObject *result = NULL;
1998 PyObject *temp, *item, *iter;
1999
Raymond Hettinger5cf63942003-10-25 06:41:37 +00002000 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
Alex Martellia70b1912003-04-22 08:12:33 +00002001 return NULL;
2002
2003 iter = PyObject_GetIter(seq);
2004 if (iter == NULL)
2005 return NULL;
2006
2007 if (result == NULL) {
2008 result = PyInt_FromLong(0);
2009 if (result == NULL) {
2010 Py_DECREF(iter);
2011 return NULL;
2012 }
2013 } else {
2014 /* reject string values for 'start' parameter */
2015 if (PyObject_TypeCheck(result, &PyBaseString_Type)) {
2016 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002017 "sum() can't sum strings [use ''.join(seq) instead]");
Alex Martellia70b1912003-04-22 08:12:33 +00002018 Py_DECREF(iter);
2019 return NULL;
2020 }
Alex Martelli41c9f882003-04-22 09:24:48 +00002021 Py_INCREF(result);
Alex Martellia70b1912003-04-22 08:12:33 +00002022 }
2023
2024 for(;;) {
2025 item = PyIter_Next(iter);
2026 if (item == NULL) {
2027 /* error, or end-of-sequence */
2028 if (PyErr_Occurred()) {
2029 Py_DECREF(result);
2030 result = NULL;
2031 }
2032 break;
2033 }
Alex Martellia253e182003-10-25 23:24:14 +00002034 temp = PyNumber_Add(result, item);
Alex Martellia70b1912003-04-22 08:12:33 +00002035 Py_DECREF(result);
2036 Py_DECREF(item);
2037 result = temp;
2038 if (result == NULL)
2039 break;
2040 }
2041 Py_DECREF(iter);
2042 return result;
2043}
2044
2045PyDoc_STRVAR(sum_doc,
2046"sum(sequence, start=0) -> value\n\
2047\n\
2048Returns the sum of a sequence of numbers (NOT strings) plus the value\n\
2049of parameter 'start'. When the sequence is empty, returns start.");
2050
2051
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002052static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002053builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002054{
2055 PyObject *inst;
2056 PyObject *cls;
Guido van Rossum823649d2001-03-21 18:40:58 +00002057 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002058
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002059 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002060 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002061
Guido van Rossum823649d2001-03-21 18:40:58 +00002062 retval = PyObject_IsInstance(inst, cls);
2063 if (retval < 0)
Guido van Rossumad991772001-01-12 16:03:05 +00002064 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002065 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002066}
2067
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002068PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002069"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002070\n\
2071Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002072With a type as second argument, return whether that is the object's type.\n\
2073The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002074isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002075
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002076
2077static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002078builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002079{
2080 PyObject *derived;
2081 PyObject *cls;
2082 int retval;
2083
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002084 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002085 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002086
Guido van Rossum823649d2001-03-21 18:40:58 +00002087 retval = PyObject_IsSubclass(derived, cls);
2088 if (retval < 0)
2089 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002090 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002091}
2092
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002093PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002094"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002095\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002096Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2097When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2098is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002099
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002100
Barry Warsawbd599b52000-08-03 15:45:29 +00002101static PyObject*
2102builtin_zip(PyObject *self, PyObject *args)
2103{
2104 PyObject *ret;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002105 const Py_ssize_t itemsize = PySequence_Length(args);
2106 Py_ssize_t i;
Tim Peters8572b4f2001-05-06 01:05:02 +00002107 PyObject *itlist; /* tuple of iterators */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002108 Py_ssize_t len; /* guess at result length */
Barry Warsawbd599b52000-08-03 15:45:29 +00002109
Raymond Hettingereaef6152003-08-02 07:42:57 +00002110 if (itemsize == 0)
2111 return PyList_New(0);
2112
Barry Warsawbd599b52000-08-03 15:45:29 +00002113 /* args must be a tuple */
2114 assert(PyTuple_Check(args));
2115
Tim Peters39a86c22002-05-12 07:19:38 +00002116 /* Guess at result length: the shortest of the input lengths.
2117 If some argument refuses to say, we refuse to guess too, lest
2118 an argument like xrange(sys.maxint) lead us astray.*/
Tim Peters67d687a2002-04-29 21:27:32 +00002119 len = -1; /* unknown */
2120 for (i = 0; i < itemsize; ++i) {
2121 PyObject *item = PyTuple_GET_ITEM(args, i);
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002122 Py_ssize_t thislen = _PyObject_LengthHint(item);
Tim Peters39a86c22002-05-12 07:19:38 +00002123 if (thislen < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +00002124 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
2125 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
2126 return NULL;
2127 }
Tim Peters67d687a2002-04-29 21:27:32 +00002128 PyErr_Clear();
Tim Peters39a86c22002-05-12 07:19:38 +00002129 len = -1;
2130 break;
2131 }
Tim Peters67d687a2002-04-29 21:27:32 +00002132 else if (len < 0 || thislen < len)
2133 len = thislen;
2134 }
2135
Tim Peters8572b4f2001-05-06 01:05:02 +00002136 /* allocate result list */
Tim Peters67d687a2002-04-29 21:27:32 +00002137 if (len < 0)
2138 len = 10; /* arbitrary */
2139 if ((ret = PyList_New(len)) == NULL)
Barry Warsawbd599b52000-08-03 15:45:29 +00002140 return NULL;
2141
Tim Peters8572b4f2001-05-06 01:05:02 +00002142 /* obtain iterators */
2143 itlist = PyTuple_New(itemsize);
2144 if (itlist == NULL)
2145 goto Fail_ret;
2146 for (i = 0; i < itemsize; ++i) {
2147 PyObject *item = PyTuple_GET_ITEM(args, i);
2148 PyObject *it = PyObject_GetIter(item);
2149 if (it == NULL) {
2150 if (PyErr_ExceptionMatches(PyExc_TypeError))
2151 PyErr_Format(PyExc_TypeError,
Neal Norwitza361bd82006-02-19 19:31:50 +00002152 "zip argument #%zd must support iteration",
Tim Peters8572b4f2001-05-06 01:05:02 +00002153 i+1);
2154 goto Fail_ret_itlist;
Barry Warsawbd599b52000-08-03 15:45:29 +00002155 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002156 PyTuple_SET_ITEM(itlist, i, it);
2157 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002158
Tim Peters8572b4f2001-05-06 01:05:02 +00002159 /* build result into ret list */
Tim Peters67d687a2002-04-29 21:27:32 +00002160 for (i = 0; ; ++i) {
2161 int j;
Tim Peters8572b4f2001-05-06 01:05:02 +00002162 PyObject *next = PyTuple_New(itemsize);
2163 if (!next)
2164 goto Fail_ret_itlist;
2165
Tim Peters67d687a2002-04-29 21:27:32 +00002166 for (j = 0; j < itemsize; j++) {
2167 PyObject *it = PyTuple_GET_ITEM(itlist, j);
Tim Peters8572b4f2001-05-06 01:05:02 +00002168 PyObject *item = PyIter_Next(it);
Barry Warsawbd599b52000-08-03 15:45:29 +00002169 if (!item) {
Tim Peters8572b4f2001-05-06 01:05:02 +00002170 if (PyErr_Occurred()) {
2171 Py_DECREF(ret);
2172 ret = NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002173 }
2174 Py_DECREF(next);
Tim Peters8572b4f2001-05-06 01:05:02 +00002175 Py_DECREF(itlist);
Tim Peters67d687a2002-04-29 21:27:32 +00002176 goto Done;
Barry Warsawbd599b52000-08-03 15:45:29 +00002177 }
Tim Peters67d687a2002-04-29 21:27:32 +00002178 PyTuple_SET_ITEM(next, j, item);
Barry Warsawbd599b52000-08-03 15:45:29 +00002179 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002180
Tim Peters67d687a2002-04-29 21:27:32 +00002181 if (i < len)
2182 PyList_SET_ITEM(ret, i, next);
2183 else {
2184 int status = PyList_Append(ret, next);
2185 Py_DECREF(next);
2186 ++len;
2187 if (status < 0)
2188 goto Fail_ret_itlist;
2189 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002190 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002191
Tim Peters67d687a2002-04-29 21:27:32 +00002192Done:
2193 if (ret != NULL && i < len) {
2194 /* The list is too big. */
2195 if (PyList_SetSlice(ret, i, len, NULL) < 0)
2196 return NULL;
2197 }
2198 return ret;
2199
Tim Peters8572b4f2001-05-06 01:05:02 +00002200Fail_ret_itlist:
2201 Py_DECREF(itlist);
2202Fail_ret:
2203 Py_DECREF(ret);
2204 return NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002205}
2206
2207
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002208PyDoc_STRVAR(zip_doc,
Barry Warsawbd599b52000-08-03 15:45:29 +00002209"zip(seq1 [, seq2 [...]]) -> [(seq1[0], seq2[0] ...), (...)]\n\
2210\n\
2211Return a list of tuples, where each tuple contains the i-th element\n\
2212from each of the argument sequences. The returned list is truncated\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002213in length to the length of the shortest argument sequence.");
Barry Warsawbd599b52000-08-03 15:45:29 +00002214
2215
Guido van Rossum79f25d91997-04-29 20:08:16 +00002216static PyMethodDef builtin_methods[] = {
Neal Norwitz92e212f2006-04-03 04:48:37 +00002217 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002218 {"abs", builtin_abs, METH_O, abs_doc},
Raymond Hettinger96229b12005-03-11 06:49:40 +00002219 {"all", builtin_all, METH_O, all_doc},
2220 {"any", builtin_any, METH_O, any_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002221 {"apply", builtin_apply, METH_VARARGS, apply_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002222 {"callable", builtin_callable, METH_O, callable_doc},
2223 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2224 {"cmp", builtin_cmp, METH_VARARGS, cmp_doc},
2225 {"coerce", builtin_coerce, METH_VARARGS, coerce_doc},
2226 {"compile", builtin_compile, METH_VARARGS, compile_doc},
2227 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2228 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2229 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2230 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2231 {"execfile", builtin_execfile, METH_VARARGS, execfile_doc},
2232 {"filter", builtin_filter, METH_VARARGS, filter_doc},
2233 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2234 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2235 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2236 {"hash", builtin_hash, METH_O, hash_doc},
2237 {"hex", builtin_hex, METH_O, hex_doc},
2238 {"id", builtin_id, METH_O, id_doc},
2239 {"input", builtin_input, METH_VARARGS, input_doc},
2240 {"intern", builtin_intern, METH_VARARGS, intern_doc},
2241 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2242 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2243 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2244 {"len", builtin_len, METH_O, len_doc},
2245 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2246 {"map", builtin_map, METH_VARARGS, map_doc},
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00002247 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2248 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002249 {"oct", builtin_oct, METH_O, oct_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002250 {"ord", builtin_ord, METH_O, ord_doc},
2251 {"pow", builtin_pow, METH_VARARGS, pow_doc},
2252 {"range", builtin_range, METH_VARARGS, range_doc},
2253 {"raw_input", builtin_raw_input, METH_VARARGS, raw_input_doc},
2254 {"reduce", builtin_reduce, METH_VARARGS, reduce_doc},
2255 {"reload", builtin_reload, METH_O, reload_doc},
2256 {"repr", builtin_repr, METH_O, repr_doc},
Georg Brandlccadf842006-03-31 18:54:53 +00002257 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002258 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
Raymond Hettinger64958a12003-12-17 20:43:33 +00002259 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
Alex Martellia70b1912003-04-22 08:12:33 +00002260 {"sum", builtin_sum, METH_VARARGS, sum_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002261#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002262 {"unichr", builtin_unichr, METH_VARARGS, unichr_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002263#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002264 {"vars", builtin_vars, METH_VARARGS, vars_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002265 {"zip", builtin_zip, METH_VARARGS, zip_doc},
Guido van Rossumc02e15c1991-12-16 13:03:00 +00002266 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002267};
2268
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002269PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002270"Built-in functions, exceptions, and other objects.\n\
2271\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002272Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002273
Guido van Rossum25ce5661997-08-02 03:10:38 +00002274PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002275_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002276{
Fred Drake5550de32000-06-20 04:54:19 +00002277 PyObject *mod, *dict, *debug;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002278 mod = Py_InitModule4("__builtin__", builtin_methods,
2279 builtin_doc, (PyObject *)NULL,
2280 PYTHON_API_VERSION);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002281 if (mod == NULL)
2282 return NULL;
2283 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002284
Tim Peters7571a0f2003-03-23 17:52:28 +00002285#ifdef Py_TRACE_REFS
2286 /* __builtin__ exposes a number of statically allocated objects
2287 * that, before this code was added in 2.3, never showed up in
2288 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2289 * result, programs leaking references to None and False (etc)
2290 * couldn't be diagnosed by examining sys.getobjects(0).
2291 */
2292#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2293#else
2294#define ADD_TO_ALL(OBJECT) (void)0
2295#endif
2296
Tim Peters4b7625e2001-09-13 21:37:17 +00002297#define SETBUILTIN(NAME, OBJECT) \
Tim Peters7571a0f2003-03-23 17:52:28 +00002298 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2299 return NULL; \
2300 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002301
2302 SETBUILTIN("None", Py_None);
2303 SETBUILTIN("Ellipsis", Py_Ellipsis);
2304 SETBUILTIN("NotImplemented", Py_NotImplemented);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002305 SETBUILTIN("False", Py_False);
2306 SETBUILTIN("True", Py_True);
Neal Norwitz32a7e7f2002-05-31 19:58:02 +00002307 SETBUILTIN("basestring", &PyBaseString_Type);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002308 SETBUILTIN("bool", &PyBool_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002309 SETBUILTIN("buffer", &PyBuffer_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002310 SETBUILTIN("classmethod", &PyClassMethod_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002311#ifndef WITHOUT_COMPLEX
Tim Peters4b7625e2001-09-13 21:37:17 +00002312 SETBUILTIN("complex", &PyComplex_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002313#endif
Tim Petersa427a2b2001-10-29 22:25:45 +00002314 SETBUILTIN("dict", &PyDict_Type);
Tim Peters67d687a2002-04-29 21:27:32 +00002315 SETBUILTIN("enumerate", &PyEnum_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002316 SETBUILTIN("float", &PyFloat_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002317 SETBUILTIN("frozenset", &PyFrozenSet_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002318 SETBUILTIN("property", &PyProperty_Type);
2319 SETBUILTIN("int", &PyInt_Type);
2320 SETBUILTIN("list", &PyList_Type);
2321 SETBUILTIN("long", &PyLong_Type);
2322 SETBUILTIN("object", &PyBaseObject_Type);
Raymond Hettinger85c20a42003-11-06 14:06:48 +00002323 SETBUILTIN("reversed", &PyReversed_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002324 SETBUILTIN("set", &PySet_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002325 SETBUILTIN("slice", &PySlice_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002326 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2327 SETBUILTIN("str", &PyString_Type);
2328 SETBUILTIN("super", &PySuper_Type);
2329 SETBUILTIN("tuple", &PyTuple_Type);
2330 SETBUILTIN("type", &PyType_Type);
Raymond Hettingerc4c453f2002-06-05 23:12:45 +00002331 SETBUILTIN("xrange", &PyRange_Type);
Tim Peters742dfd62001-09-13 21:49:44 +00002332
2333 /* Note that open() is just an alias of file(). */
2334 SETBUILTIN("open", &PyFile_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002335 SETBUILTIN("file", &PyFile_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002336#ifdef Py_USING_UNICODE
Tim Peters4b7625e2001-09-13 21:37:17 +00002337 SETBUILTIN("unicode", &PyUnicode_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002338#endif
Guido van Rossum77f6a652002-04-03 22:41:51 +00002339 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
Fred Drake5550de32000-06-20 04:54:19 +00002340 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2341 Py_XDECREF(debug);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002342 return NULL;
Fred Drake5550de32000-06-20 04:54:19 +00002343 }
2344 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002345
Guido van Rossum25ce5661997-08-02 03:10:38 +00002346 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002347#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002348#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002349}
2350
Guido van Rossume77a7571993-11-03 15:01:26 +00002351/* Helper for filter(): filter a tuple through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002352
Guido van Rossum79f25d91997-04-29 20:08:16 +00002353static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002354filtertuple(PyObject *func, PyObject *tuple)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002355{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002356 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002357 Py_ssize_t i, j;
2358 Py_ssize_t len = PyTuple_Size(tuple);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002359
Guido van Rossumb7b45621995-08-04 04:07:45 +00002360 if (len == 0) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002361 if (PyTuple_CheckExact(tuple))
2362 Py_INCREF(tuple);
2363 else
2364 tuple = PyTuple_New(0);
Guido van Rossumb7b45621995-08-04 04:07:45 +00002365 return tuple;
2366 }
2367
Guido van Rossum79f25d91997-04-29 20:08:16 +00002368 if ((result = PyTuple_New(len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002369 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002370
Guido van Rossum12d12c51993-10-26 17:58:25 +00002371 for (i = j = 0; i < len; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002372 PyObject *item, *good;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002373 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002374
Walter Dörwald8dd19322003-02-10 17:36:40 +00002375 if (tuple->ob_type->tp_as_sequence &&
2376 tuple->ob_type->tp_as_sequence->sq_item) {
2377 item = tuple->ob_type->tp_as_sequence->sq_item(tuple, i);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002378 if (item == NULL)
2379 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002380 } else {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002381 PyErr_SetString(PyExc_TypeError, "filter(): unsubscriptable tuple");
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002382 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002383 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002384 if (func == Py_None) {
2385 Py_INCREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002386 good = item;
2387 }
2388 else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002389 PyObject *arg = PyTuple_Pack(1, item);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002390 if (arg == NULL) {
2391 Py_DECREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002392 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002393 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002394 good = PyEval_CallObject(func, arg);
2395 Py_DECREF(arg);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002396 if (good == NULL) {
2397 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002398 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002399 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002400 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002401 ok = PyObject_IsTrue(good);
2402 Py_DECREF(good);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002403 if (ok) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002404 if (PyTuple_SetItem(result, j++, item) < 0)
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002405 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002406 }
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002407 else
2408 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002409 }
2410
Tim Peters4324aa32001-05-28 22:30:08 +00002411 if (_PyTuple_Resize(&result, j) < 0)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002412 return NULL;
2413
Guido van Rossum12d12c51993-10-26 17:58:25 +00002414 return result;
2415
Guido van Rossum12d12c51993-10-26 17:58:25 +00002416Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002417 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002418 return NULL;
2419}
2420
2421
Guido van Rossume77a7571993-11-03 15:01:26 +00002422/* Helper for filter(): filter a string through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002423
Guido van Rossum79f25d91997-04-29 20:08:16 +00002424static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002425filterstring(PyObject *func, PyObject *strobj)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002426{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002427 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002428 Py_ssize_t i, j;
2429 Py_ssize_t len = PyString_Size(strobj);
2430 Py_ssize_t outlen = len;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002431
Guido van Rossum79f25d91997-04-29 20:08:16 +00002432 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002433 /* If it's a real string we can return the original,
2434 * as no character is ever false and __getitem__
2435 * does return this character. If it's a subclass
2436 * we must go through the __getitem__ loop */
2437 if (PyString_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002438 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002439 return strobj;
2440 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002441 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002442 if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002443 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002444
Guido van Rossum12d12c51993-10-26 17:58:25 +00002445 for (i = j = 0; i < len; ++i) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002446 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002447 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002448
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002449 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2450 if (item == NULL)
2451 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002452 if (func==Py_None) {
2453 ok = 1;
2454 } else {
2455 PyObject *arg, *good;
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002456 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002457 if (arg == NULL) {
2458 Py_DECREF(item);
2459 goto Fail_1;
2460 }
2461 good = PyEval_CallObject(func, arg);
2462 Py_DECREF(arg);
2463 if (good == NULL) {
2464 Py_DECREF(item);
2465 goto Fail_1;
2466 }
2467 ok = PyObject_IsTrue(good);
2468 Py_DECREF(good);
Tim Peters388ed082001-04-07 20:34:48 +00002469 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002470 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002471 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002472 if (!PyString_Check(item)) {
2473 PyErr_SetString(PyExc_TypeError, "can't filter str to str:"
2474 " __getitem__ returned different type");
2475 Py_DECREF(item);
2476 goto Fail_1;
2477 }
2478 reslen = PyString_GET_SIZE(item);
2479 if (reslen == 1) {
2480 PyString_AS_STRING(result)[j++] =
2481 PyString_AS_STRING(item)[0];
2482 } else {
2483 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002484 Py_ssize_t need = j + reslen + len-i-1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002485 if (need > outlen) {
2486 /* overallocate, to avoid reallocations */
2487 if (need<2*outlen)
2488 need = 2*outlen;
2489 if (_PyString_Resize(&result, need)) {
2490 Py_DECREF(item);
2491 return NULL;
2492 }
2493 outlen = need;
2494 }
2495 memcpy(
2496 PyString_AS_STRING(result) + j,
2497 PyString_AS_STRING(item),
2498 reslen
2499 );
2500 j += reslen;
2501 }
2502 }
Tim Peters388ed082001-04-07 20:34:48 +00002503 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002504 }
2505
Walter Dörwald903f1e02003-02-04 16:28:00 +00002506 if (j < outlen)
Tim Peters5de98422002-04-27 18:44:32 +00002507 _PyString_Resize(&result, j);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002508
Guido van Rossum12d12c51993-10-26 17:58:25 +00002509 return result;
2510
Guido van Rossum12d12c51993-10-26 17:58:25 +00002511Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002512 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002513 return NULL;
2514}
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002515
2516#ifdef Py_USING_UNICODE
2517/* Helper for filter(): filter a Unicode object through a function */
2518
2519static PyObject *
2520filterunicode(PyObject *func, PyObject *strobj)
2521{
2522 PyObject *result;
Martin v. Löwis725507b2006-03-07 12:08:51 +00002523 register Py_ssize_t i, j;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002524 Py_ssize_t len = PyUnicode_GetSize(strobj);
2525 Py_ssize_t outlen = len;
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002526
2527 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002528 /* If it's a real string we can return the original,
2529 * as no character is ever false and __getitem__
2530 * does return this character. If it's a subclass
2531 * we must go through the __getitem__ loop */
2532 if (PyUnicode_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002533 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002534 return strobj;
2535 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002536 }
2537 if ((result = PyUnicode_FromUnicode(NULL, len)) == NULL)
2538 return NULL;
2539
2540 for (i = j = 0; i < len; ++i) {
2541 PyObject *item, *arg, *good;
2542 int ok;
2543
2544 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2545 if (item == NULL)
2546 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002547 if (func == Py_None) {
2548 ok = 1;
2549 } else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002550 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002551 if (arg == NULL) {
2552 Py_DECREF(item);
2553 goto Fail_1;
2554 }
2555 good = PyEval_CallObject(func, arg);
2556 Py_DECREF(arg);
2557 if (good == NULL) {
2558 Py_DECREF(item);
2559 goto Fail_1;
2560 }
2561 ok = PyObject_IsTrue(good);
2562 Py_DECREF(good);
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002563 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002564 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002565 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002566 if (!PyUnicode_Check(item)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002567 PyErr_SetString(PyExc_TypeError,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002568 "can't filter unicode to unicode:"
2569 " __getitem__ returned different type");
Walter Dörwald903f1e02003-02-04 16:28:00 +00002570 Py_DECREF(item);
2571 goto Fail_1;
2572 }
2573 reslen = PyUnicode_GET_SIZE(item);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002574 if (reslen == 1)
Walter Dörwald903f1e02003-02-04 16:28:00 +00002575 PyUnicode_AS_UNICODE(result)[j++] =
2576 PyUnicode_AS_UNICODE(item)[0];
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002577 else {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002578 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002579 Py_ssize_t need = j + reslen + len - i - 1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002580 if (need > outlen) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002581 /* overallocate,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002582 to avoid reallocations */
2583 if (need < 2 * outlen)
2584 need = 2 * outlen;
Jeremy Hylton364f6be2003-09-16 03:17:16 +00002585 if (PyUnicode_Resize(
2586 &result, need) < 0) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002587 Py_DECREF(item);
Walter Dörwald531e0002003-02-04 16:57:49 +00002588 goto Fail_1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002589 }
2590 outlen = need;
2591 }
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002592 memcpy(PyUnicode_AS_UNICODE(result) + j,
2593 PyUnicode_AS_UNICODE(item),
2594 reslen*sizeof(Py_UNICODE));
Walter Dörwald903f1e02003-02-04 16:28:00 +00002595 j += reslen;
2596 }
2597 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002598 Py_DECREF(item);
2599 }
2600
Walter Dörwald903f1e02003-02-04 16:28:00 +00002601 if (j < outlen)
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002602 PyUnicode_Resize(&result, j);
2603
2604 return result;
2605
2606Fail_1:
2607 Py_DECREF(result);
2608 return NULL;
2609}
2610#endif