blob: fe923ac387f87f68c7baa21d628e93c19d7cd3d8 [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);
1749 if (len > INT_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öwis31d2df52002-08-14 15:46:02 +00001755 result = PyString_FromStringAndSize(s,
1756 (int)(len-1));
Guido van Rossum106f2da2000-06-28 21:12:25 +00001757 }
Guido van Rossum872537c1995-07-07 22:43:42 +00001758 }
Guido van Rossumb18618d2000-05-03 23:44:39 +00001759 PyMem_FREE(s);
Guido van Rossum872537c1995-07-07 22:43:42 +00001760 return result;
1761 }
Guido van Rossum90933611991-06-07 16:10:43 +00001762 if (v != NULL) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001763 if (PyFile_WriteObject(v, fout, Py_PRINT_RAW) != 0)
Guido van Rossum90933611991-06-07 16:10:43 +00001764 return NULL;
1765 }
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001766 return PyFile_GetLine(fin, -1);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001767}
1768
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001769PyDoc_STRVAR(raw_input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001770"raw_input([prompt]) -> string\n\
1771\n\
1772Read a string from standard input. The trailing newline is stripped.\n\
1773If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
1774On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001775is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001776
1777
Guido van Rossum79f25d91997-04-29 20:08:16 +00001778static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001779builtin_reduce(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +00001780{
Tim Peters15d81ef2001-05-04 04:39:21 +00001781 PyObject *seq, *func, *result = NULL, *it;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001782
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001783 if (!PyArg_UnpackTuple(args, "reduce", 2, 3, &func, &seq, &result))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001784 return NULL;
1785 if (result != NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00001786 Py_INCREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001787
Tim Peters15d81ef2001-05-04 04:39:21 +00001788 it = PyObject_GetIter(seq);
1789 if (it == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001790 PyErr_SetString(PyExc_TypeError,
Tim Peters15d81ef2001-05-04 04:39:21 +00001791 "reduce() arg 2 must support iteration");
1792 Py_XDECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001793 return NULL;
1794 }
1795
Guido van Rossum79f25d91997-04-29 20:08:16 +00001796 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001797 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001798
Tim Peters15d81ef2001-05-04 04:39:21 +00001799 for (;;) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001800 PyObject *op2;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001801
1802 if (args->ob_refcnt > 1) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001803 Py_DECREF(args);
1804 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001805 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001806 }
1807
Tim Peters15d81ef2001-05-04 04:39:21 +00001808 op2 = PyIter_Next(it);
1809 if (op2 == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +00001810 if (PyErr_Occurred())
1811 goto Fail;
1812 break;
Guido van Rossum2d951851994-08-29 12:52:16 +00001813 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001814
Guido van Rossum2d951851994-08-29 12:52:16 +00001815 if (result == NULL)
1816 result = op2;
1817 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001818 PyTuple_SetItem(args, 0, result);
1819 PyTuple_SetItem(args, 1, op2);
1820 if ((result = PyEval_CallObject(func, args)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001821 goto Fail;
1822 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001823 }
1824
Guido van Rossum79f25d91997-04-29 20:08:16 +00001825 Py_DECREF(args);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001826
Guido van Rossum2d951851994-08-29 12:52:16 +00001827 if (result == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00001828 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +00001829 "reduce() of empty sequence with no initial value");
Guido van Rossum2d951851994-08-29 12:52:16 +00001830
Tim Peters15d81ef2001-05-04 04:39:21 +00001831 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001832 return result;
1833
Guido van Rossum2d951851994-08-29 12:52:16 +00001834Fail:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001835 Py_XDECREF(args);
1836 Py_XDECREF(result);
Tim Peters15d81ef2001-05-04 04:39:21 +00001837 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001838 return NULL;
1839}
1840
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001841PyDoc_STRVAR(reduce_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001842"reduce(function, sequence[, initial]) -> value\n\
1843\n\
1844Apply a function of two arguments cumulatively to the items of a sequence,\n\
1845from left to right, so as to reduce the sequence to a single value.\n\
1846For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates\n\
1847((((1+2)+3)+4)+5). If initial is present, it is placed before the items\n\
1848of the sequence in the calculation, and serves as a default when the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001849sequence is empty.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001850
1851
Guido van Rossum79f25d91997-04-29 20:08:16 +00001852static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001853builtin_reload(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001854{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001855 return PyImport_ReloadModule(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001856}
1857
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001858PyDoc_STRVAR(reload_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001859"reload(module) -> module\n\
1860\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001861Reload the module. The module must have been successfully imported before.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001862
1863
Guido van Rossum79f25d91997-04-29 20:08:16 +00001864static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001865builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00001866{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001867 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00001868}
1869
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001870PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001871"repr(object) -> string\n\
1872\n\
1873Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001874For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001875
1876
Guido van Rossum79f25d91997-04-29 20:08:16 +00001877static PyObject *
Georg Brandlccadf842006-03-31 18:54:53 +00001878builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001879{
Georg Brandlccadf842006-03-31 18:54:53 +00001880 double number;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001881 double f;
1882 int ndigits = 0;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001883 int i;
Georg Brandlccadf842006-03-31 18:54:53 +00001884 static char *kwlist[] = {"number", "ndigits", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001885
Georg Brandlccadf842006-03-31 18:54:53 +00001886 if (!PyArg_ParseTupleAndKeywords(args, kwds, "d|i:round",
1887 kwlist, &number, &ndigits))
1888 return NULL;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001889 f = 1.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001890 i = abs(ndigits);
1891 while (--i >= 0)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001892 f = f*10.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001893 if (ndigits < 0)
Georg Brandlccadf842006-03-31 18:54:53 +00001894 number /= f;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001895 else
Georg Brandlccadf842006-03-31 18:54:53 +00001896 number *= f;
1897 if (number >= 0.0)
1898 number = floor(number + 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001899 else
Georg Brandlccadf842006-03-31 18:54:53 +00001900 number = ceil(number - 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001901 if (ndigits < 0)
Georg Brandlccadf842006-03-31 18:54:53 +00001902 number *= f;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001903 else
Georg Brandlccadf842006-03-31 18:54:53 +00001904 number /= f;
1905 return PyFloat_FromDouble(number);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001906}
1907
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001908PyDoc_STRVAR(round_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001909"round(number[, ndigits]) -> floating point number\n\
1910\n\
1911Round a number to a given precision in decimal digits (default 0 digits).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001912This always returns a floating point number. Precision may be negative.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001913
Raymond Hettinger64958a12003-12-17 20:43:33 +00001914static PyObject *
1915builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
1916{
1917 PyObject *newlist, *v, *seq, *compare=NULL, *keyfunc=NULL, *newargs;
1918 PyObject *callable;
Martin v. Löwis15e62742006-02-27 16:46:16 +00001919 static char *kwlist[] = {"iterable", "cmp", "key", "reverse", 0};
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001920 int reverse;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001921
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001922 /* args 1-4 should match listsort in Objects/listobject.c */
Armin Rigo71d7e702005-09-20 18:13:03 +00001923 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|OOi:sorted",
1924 kwlist, &seq, &compare, &keyfunc, &reverse))
1925 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001926
1927 newlist = PySequence_List(seq);
1928 if (newlist == NULL)
1929 return NULL;
1930
1931 callable = PyObject_GetAttrString(newlist, "sort");
1932 if (callable == NULL) {
1933 Py_DECREF(newlist);
1934 return NULL;
1935 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001936
Raymond Hettinger64958a12003-12-17 20:43:33 +00001937 newargs = PyTuple_GetSlice(args, 1, 4);
1938 if (newargs == NULL) {
1939 Py_DECREF(newlist);
1940 Py_DECREF(callable);
1941 return NULL;
1942 }
1943
1944 v = PyObject_Call(callable, newargs, kwds);
1945 Py_DECREF(newargs);
1946 Py_DECREF(callable);
1947 if (v == NULL) {
1948 Py_DECREF(newlist);
1949 return NULL;
1950 }
1951 Py_DECREF(v);
1952 return newlist;
1953}
1954
1955PyDoc_STRVAR(sorted_doc,
1956"sorted(iterable, cmp=None, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001957
Guido van Rossum79f25d91997-04-29 20:08:16 +00001958static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001959builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00001960{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001961 PyObject *v = NULL;
1962 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001963
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001964 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001965 return NULL;
Guido van Rossum2d951851994-08-29 12:52:16 +00001966 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001967 d = PyEval_GetLocals();
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001968 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001969 if (!PyErr_Occurred())
1970 PyErr_SetString(PyExc_SystemError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001971 "vars(): no locals!?");
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001972 }
1973 else
Guido van Rossum79f25d91997-04-29 20:08:16 +00001974 Py_INCREF(d);
Guido van Rossum2d951851994-08-29 12:52:16 +00001975 }
1976 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001977 d = PyObject_GetAttrString(v, "__dict__");
Guido van Rossum2d951851994-08-29 12:52:16 +00001978 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001979 PyErr_SetString(PyExc_TypeError,
Guido van Rossum2d951851994-08-29 12:52:16 +00001980 "vars() argument must have __dict__ attribute");
1981 return NULL;
1982 }
1983 }
1984 return d;
1985}
1986
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001987PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001988"vars([object]) -> dictionary\n\
1989\n\
1990Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001991With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001992
Alex Martellia70b1912003-04-22 08:12:33 +00001993
1994static PyObject*
1995builtin_sum(PyObject *self, PyObject *args)
1996{
1997 PyObject *seq;
1998 PyObject *result = NULL;
1999 PyObject *temp, *item, *iter;
2000
Raymond Hettinger5cf63942003-10-25 06:41:37 +00002001 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
Alex Martellia70b1912003-04-22 08:12:33 +00002002 return NULL;
2003
2004 iter = PyObject_GetIter(seq);
2005 if (iter == NULL)
2006 return NULL;
2007
2008 if (result == NULL) {
2009 result = PyInt_FromLong(0);
2010 if (result == NULL) {
2011 Py_DECREF(iter);
2012 return NULL;
2013 }
2014 } else {
2015 /* reject string values for 'start' parameter */
2016 if (PyObject_TypeCheck(result, &PyBaseString_Type)) {
2017 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002018 "sum() can't sum strings [use ''.join(seq) instead]");
Alex Martellia70b1912003-04-22 08:12:33 +00002019 Py_DECREF(iter);
2020 return NULL;
2021 }
Alex Martelli41c9f882003-04-22 09:24:48 +00002022 Py_INCREF(result);
Alex Martellia70b1912003-04-22 08:12:33 +00002023 }
2024
2025 for(;;) {
2026 item = PyIter_Next(iter);
2027 if (item == NULL) {
2028 /* error, or end-of-sequence */
2029 if (PyErr_Occurred()) {
2030 Py_DECREF(result);
2031 result = NULL;
2032 }
2033 break;
2034 }
Alex Martellia253e182003-10-25 23:24:14 +00002035 temp = PyNumber_Add(result, item);
Alex Martellia70b1912003-04-22 08:12:33 +00002036 Py_DECREF(result);
2037 Py_DECREF(item);
2038 result = temp;
2039 if (result == NULL)
2040 break;
2041 }
2042 Py_DECREF(iter);
2043 return result;
2044}
2045
2046PyDoc_STRVAR(sum_doc,
2047"sum(sequence, start=0) -> value\n\
2048\n\
2049Returns the sum of a sequence of numbers (NOT strings) plus the value\n\
2050of parameter 'start'. When the sequence is empty, returns start.");
2051
2052
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002053static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002054builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002055{
2056 PyObject *inst;
2057 PyObject *cls;
Guido van Rossum823649d2001-03-21 18:40:58 +00002058 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002059
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002060 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002061 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002062
Guido van Rossum823649d2001-03-21 18:40:58 +00002063 retval = PyObject_IsInstance(inst, cls);
2064 if (retval < 0)
Guido van Rossumad991772001-01-12 16:03:05 +00002065 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002066 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002067}
2068
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002069PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002070"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002071\n\
2072Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002073With a type as second argument, return whether that is the object's type.\n\
2074The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002075isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002076
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002077
2078static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002079builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002080{
2081 PyObject *derived;
2082 PyObject *cls;
2083 int retval;
2084
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002085 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002086 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002087
Guido van Rossum823649d2001-03-21 18:40:58 +00002088 retval = PyObject_IsSubclass(derived, cls);
2089 if (retval < 0)
2090 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002091 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002092}
2093
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002094PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002095"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002096\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002097Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2098When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2099is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002100
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002101
Barry Warsawbd599b52000-08-03 15:45:29 +00002102static PyObject*
2103builtin_zip(PyObject *self, PyObject *args)
2104{
2105 PyObject *ret;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002106 const Py_ssize_t itemsize = PySequence_Length(args);
2107 Py_ssize_t i;
Tim Peters8572b4f2001-05-06 01:05:02 +00002108 PyObject *itlist; /* tuple of iterators */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002109 Py_ssize_t len; /* guess at result length */
Barry Warsawbd599b52000-08-03 15:45:29 +00002110
Raymond Hettingereaef6152003-08-02 07:42:57 +00002111 if (itemsize == 0)
2112 return PyList_New(0);
2113
Barry Warsawbd599b52000-08-03 15:45:29 +00002114 /* args must be a tuple */
2115 assert(PyTuple_Check(args));
2116
Tim Peters39a86c22002-05-12 07:19:38 +00002117 /* Guess at result length: the shortest of the input lengths.
2118 If some argument refuses to say, we refuse to guess too, lest
2119 an argument like xrange(sys.maxint) lead us astray.*/
Tim Peters67d687a2002-04-29 21:27:32 +00002120 len = -1; /* unknown */
2121 for (i = 0; i < itemsize; ++i) {
2122 PyObject *item = PyTuple_GET_ITEM(args, i);
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002123 Py_ssize_t thislen = _PyObject_LengthHint(item);
Tim Peters39a86c22002-05-12 07:19:38 +00002124 if (thislen < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +00002125 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
2126 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
2127 return NULL;
2128 }
Tim Peters67d687a2002-04-29 21:27:32 +00002129 PyErr_Clear();
Tim Peters39a86c22002-05-12 07:19:38 +00002130 len = -1;
2131 break;
2132 }
Tim Peters67d687a2002-04-29 21:27:32 +00002133 else if (len < 0 || thislen < len)
2134 len = thislen;
2135 }
2136
Tim Peters8572b4f2001-05-06 01:05:02 +00002137 /* allocate result list */
Tim Peters67d687a2002-04-29 21:27:32 +00002138 if (len < 0)
2139 len = 10; /* arbitrary */
2140 if ((ret = PyList_New(len)) == NULL)
Barry Warsawbd599b52000-08-03 15:45:29 +00002141 return NULL;
2142
Tim Peters8572b4f2001-05-06 01:05:02 +00002143 /* obtain iterators */
2144 itlist = PyTuple_New(itemsize);
2145 if (itlist == NULL)
2146 goto Fail_ret;
2147 for (i = 0; i < itemsize; ++i) {
2148 PyObject *item = PyTuple_GET_ITEM(args, i);
2149 PyObject *it = PyObject_GetIter(item);
2150 if (it == NULL) {
2151 if (PyErr_ExceptionMatches(PyExc_TypeError))
2152 PyErr_Format(PyExc_TypeError,
Neal Norwitza361bd82006-02-19 19:31:50 +00002153 "zip argument #%zd must support iteration",
Tim Peters8572b4f2001-05-06 01:05:02 +00002154 i+1);
2155 goto Fail_ret_itlist;
Barry Warsawbd599b52000-08-03 15:45:29 +00002156 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002157 PyTuple_SET_ITEM(itlist, i, it);
2158 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002159
Tim Peters8572b4f2001-05-06 01:05:02 +00002160 /* build result into ret list */
Tim Peters67d687a2002-04-29 21:27:32 +00002161 for (i = 0; ; ++i) {
2162 int j;
Tim Peters8572b4f2001-05-06 01:05:02 +00002163 PyObject *next = PyTuple_New(itemsize);
2164 if (!next)
2165 goto Fail_ret_itlist;
2166
Tim Peters67d687a2002-04-29 21:27:32 +00002167 for (j = 0; j < itemsize; j++) {
2168 PyObject *it = PyTuple_GET_ITEM(itlist, j);
Tim Peters8572b4f2001-05-06 01:05:02 +00002169 PyObject *item = PyIter_Next(it);
Barry Warsawbd599b52000-08-03 15:45:29 +00002170 if (!item) {
Tim Peters8572b4f2001-05-06 01:05:02 +00002171 if (PyErr_Occurred()) {
2172 Py_DECREF(ret);
2173 ret = NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002174 }
2175 Py_DECREF(next);
Tim Peters8572b4f2001-05-06 01:05:02 +00002176 Py_DECREF(itlist);
Tim Peters67d687a2002-04-29 21:27:32 +00002177 goto Done;
Barry Warsawbd599b52000-08-03 15:45:29 +00002178 }
Tim Peters67d687a2002-04-29 21:27:32 +00002179 PyTuple_SET_ITEM(next, j, item);
Barry Warsawbd599b52000-08-03 15:45:29 +00002180 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002181
Tim Peters67d687a2002-04-29 21:27:32 +00002182 if (i < len)
2183 PyList_SET_ITEM(ret, i, next);
2184 else {
2185 int status = PyList_Append(ret, next);
2186 Py_DECREF(next);
2187 ++len;
2188 if (status < 0)
2189 goto Fail_ret_itlist;
2190 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002191 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002192
Tim Peters67d687a2002-04-29 21:27:32 +00002193Done:
2194 if (ret != NULL && i < len) {
2195 /* The list is too big. */
2196 if (PyList_SetSlice(ret, i, len, NULL) < 0)
2197 return NULL;
2198 }
2199 return ret;
2200
Tim Peters8572b4f2001-05-06 01:05:02 +00002201Fail_ret_itlist:
2202 Py_DECREF(itlist);
2203Fail_ret:
2204 Py_DECREF(ret);
2205 return NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002206}
2207
2208
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002209PyDoc_STRVAR(zip_doc,
Barry Warsawbd599b52000-08-03 15:45:29 +00002210"zip(seq1 [, seq2 [...]]) -> [(seq1[0], seq2[0] ...), (...)]\n\
2211\n\
2212Return a list of tuples, where each tuple contains the i-th element\n\
2213from each of the argument sequences. The returned list is truncated\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002214in length to the length of the shortest argument sequence.");
Barry Warsawbd599b52000-08-03 15:45:29 +00002215
2216
Guido van Rossum79f25d91997-04-29 20:08:16 +00002217static PyMethodDef builtin_methods[] = {
Neal Norwitz92e212f2006-04-03 04:48:37 +00002218 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002219 {"abs", builtin_abs, METH_O, abs_doc},
Raymond Hettinger96229b12005-03-11 06:49:40 +00002220 {"all", builtin_all, METH_O, all_doc},
2221 {"any", builtin_any, METH_O, any_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002222 {"apply", builtin_apply, METH_VARARGS, apply_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002223 {"callable", builtin_callable, METH_O, callable_doc},
2224 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2225 {"cmp", builtin_cmp, METH_VARARGS, cmp_doc},
2226 {"coerce", builtin_coerce, METH_VARARGS, coerce_doc},
2227 {"compile", builtin_compile, METH_VARARGS, compile_doc},
2228 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2229 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2230 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2231 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2232 {"execfile", builtin_execfile, METH_VARARGS, execfile_doc},
2233 {"filter", builtin_filter, METH_VARARGS, filter_doc},
2234 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2235 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2236 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2237 {"hash", builtin_hash, METH_O, hash_doc},
2238 {"hex", builtin_hex, METH_O, hex_doc},
2239 {"id", builtin_id, METH_O, id_doc},
2240 {"input", builtin_input, METH_VARARGS, input_doc},
2241 {"intern", builtin_intern, METH_VARARGS, intern_doc},
2242 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2243 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2244 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2245 {"len", builtin_len, METH_O, len_doc},
2246 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2247 {"map", builtin_map, METH_VARARGS, map_doc},
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00002248 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2249 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002250 {"oct", builtin_oct, METH_O, oct_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002251 {"ord", builtin_ord, METH_O, ord_doc},
2252 {"pow", builtin_pow, METH_VARARGS, pow_doc},
2253 {"range", builtin_range, METH_VARARGS, range_doc},
2254 {"raw_input", builtin_raw_input, METH_VARARGS, raw_input_doc},
2255 {"reduce", builtin_reduce, METH_VARARGS, reduce_doc},
2256 {"reload", builtin_reload, METH_O, reload_doc},
2257 {"repr", builtin_repr, METH_O, repr_doc},
Georg Brandlccadf842006-03-31 18:54:53 +00002258 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002259 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
Raymond Hettinger64958a12003-12-17 20:43:33 +00002260 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
Alex Martellia70b1912003-04-22 08:12:33 +00002261 {"sum", builtin_sum, METH_VARARGS, sum_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002262#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002263 {"unichr", builtin_unichr, METH_VARARGS, unichr_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002264#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002265 {"vars", builtin_vars, METH_VARARGS, vars_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002266 {"zip", builtin_zip, METH_VARARGS, zip_doc},
Guido van Rossumc02e15c1991-12-16 13:03:00 +00002267 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002268};
2269
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002270PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002271"Built-in functions, exceptions, and other objects.\n\
2272\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002273Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002274
Guido van Rossum25ce5661997-08-02 03:10:38 +00002275PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002276_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002277{
Fred Drake5550de32000-06-20 04:54:19 +00002278 PyObject *mod, *dict, *debug;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002279 mod = Py_InitModule4("__builtin__", builtin_methods,
2280 builtin_doc, (PyObject *)NULL,
2281 PYTHON_API_VERSION);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002282 if (mod == NULL)
2283 return NULL;
2284 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002285
Tim Peters7571a0f2003-03-23 17:52:28 +00002286#ifdef Py_TRACE_REFS
2287 /* __builtin__ exposes a number of statically allocated objects
2288 * that, before this code was added in 2.3, never showed up in
2289 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2290 * result, programs leaking references to None and False (etc)
2291 * couldn't be diagnosed by examining sys.getobjects(0).
2292 */
2293#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2294#else
2295#define ADD_TO_ALL(OBJECT) (void)0
2296#endif
2297
Tim Peters4b7625e2001-09-13 21:37:17 +00002298#define SETBUILTIN(NAME, OBJECT) \
Tim Peters7571a0f2003-03-23 17:52:28 +00002299 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2300 return NULL; \
2301 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002302
2303 SETBUILTIN("None", Py_None);
2304 SETBUILTIN("Ellipsis", Py_Ellipsis);
2305 SETBUILTIN("NotImplemented", Py_NotImplemented);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002306 SETBUILTIN("False", Py_False);
2307 SETBUILTIN("True", Py_True);
Neal Norwitz32a7e7f2002-05-31 19:58:02 +00002308 SETBUILTIN("basestring", &PyBaseString_Type);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002309 SETBUILTIN("bool", &PyBool_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002310 SETBUILTIN("buffer", &PyBuffer_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002311 SETBUILTIN("classmethod", &PyClassMethod_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002312#ifndef WITHOUT_COMPLEX
Tim Peters4b7625e2001-09-13 21:37:17 +00002313 SETBUILTIN("complex", &PyComplex_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002314#endif
Tim Petersa427a2b2001-10-29 22:25:45 +00002315 SETBUILTIN("dict", &PyDict_Type);
Tim Peters67d687a2002-04-29 21:27:32 +00002316 SETBUILTIN("enumerate", &PyEnum_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002317 SETBUILTIN("float", &PyFloat_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002318 SETBUILTIN("frozenset", &PyFrozenSet_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002319 SETBUILTIN("property", &PyProperty_Type);
2320 SETBUILTIN("int", &PyInt_Type);
2321 SETBUILTIN("list", &PyList_Type);
2322 SETBUILTIN("long", &PyLong_Type);
2323 SETBUILTIN("object", &PyBaseObject_Type);
Raymond Hettinger85c20a42003-11-06 14:06:48 +00002324 SETBUILTIN("reversed", &PyReversed_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002325 SETBUILTIN("set", &PySet_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002326 SETBUILTIN("slice", &PySlice_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002327 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2328 SETBUILTIN("str", &PyString_Type);
2329 SETBUILTIN("super", &PySuper_Type);
2330 SETBUILTIN("tuple", &PyTuple_Type);
2331 SETBUILTIN("type", &PyType_Type);
Raymond Hettingerc4c453f2002-06-05 23:12:45 +00002332 SETBUILTIN("xrange", &PyRange_Type);
Tim Peters742dfd62001-09-13 21:49:44 +00002333
2334 /* Note that open() is just an alias of file(). */
2335 SETBUILTIN("open", &PyFile_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002336 SETBUILTIN("file", &PyFile_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002337#ifdef Py_USING_UNICODE
Tim Peters4b7625e2001-09-13 21:37:17 +00002338 SETBUILTIN("unicode", &PyUnicode_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002339#endif
Guido van Rossum77f6a652002-04-03 22:41:51 +00002340 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
Fred Drake5550de32000-06-20 04:54:19 +00002341 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2342 Py_XDECREF(debug);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002343 return NULL;
Fred Drake5550de32000-06-20 04:54:19 +00002344 }
2345 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002346
Guido van Rossum25ce5661997-08-02 03:10:38 +00002347 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002348#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002349#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002350}
2351
Guido van Rossume77a7571993-11-03 15:01:26 +00002352/* Helper for filter(): filter a tuple through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002353
Guido van Rossum79f25d91997-04-29 20:08:16 +00002354static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002355filtertuple(PyObject *func, PyObject *tuple)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002356{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002357 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002358 Py_ssize_t i, j;
2359 Py_ssize_t len = PyTuple_Size(tuple);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002360
Guido van Rossumb7b45621995-08-04 04:07:45 +00002361 if (len == 0) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002362 if (PyTuple_CheckExact(tuple))
2363 Py_INCREF(tuple);
2364 else
2365 tuple = PyTuple_New(0);
Guido van Rossumb7b45621995-08-04 04:07:45 +00002366 return tuple;
2367 }
2368
Guido van Rossum79f25d91997-04-29 20:08:16 +00002369 if ((result = PyTuple_New(len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002370 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002371
Guido van Rossum12d12c51993-10-26 17:58:25 +00002372 for (i = j = 0; i < len; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002373 PyObject *item, *good;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002374 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002375
Walter Dörwald8dd19322003-02-10 17:36:40 +00002376 if (tuple->ob_type->tp_as_sequence &&
2377 tuple->ob_type->tp_as_sequence->sq_item) {
2378 item = tuple->ob_type->tp_as_sequence->sq_item(tuple, i);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002379 if (item == NULL)
2380 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002381 } else {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002382 PyErr_SetString(PyExc_TypeError, "filter(): unsubscriptable tuple");
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002383 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002384 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002385 if (func == Py_None) {
2386 Py_INCREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002387 good = item;
2388 }
2389 else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002390 PyObject *arg = PyTuple_Pack(1, item);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002391 if (arg == NULL) {
2392 Py_DECREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002393 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002394 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002395 good = PyEval_CallObject(func, arg);
2396 Py_DECREF(arg);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002397 if (good == NULL) {
2398 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002399 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002400 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002401 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002402 ok = PyObject_IsTrue(good);
2403 Py_DECREF(good);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002404 if (ok) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002405 if (PyTuple_SetItem(result, j++, item) < 0)
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002406 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002407 }
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002408 else
2409 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002410 }
2411
Tim Peters4324aa32001-05-28 22:30:08 +00002412 if (_PyTuple_Resize(&result, j) < 0)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002413 return NULL;
2414
Guido van Rossum12d12c51993-10-26 17:58:25 +00002415 return result;
2416
Guido van Rossum12d12c51993-10-26 17:58:25 +00002417Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002418 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002419 return NULL;
2420}
2421
2422
Guido van Rossume77a7571993-11-03 15:01:26 +00002423/* Helper for filter(): filter a string through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002424
Guido van Rossum79f25d91997-04-29 20:08:16 +00002425static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002426filterstring(PyObject *func, PyObject *strobj)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002427{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002428 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002429 Py_ssize_t i, j;
2430 Py_ssize_t len = PyString_Size(strobj);
2431 Py_ssize_t outlen = len;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002432
Guido van Rossum79f25d91997-04-29 20:08:16 +00002433 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002434 /* If it's a real string we can return the original,
2435 * as no character is ever false and __getitem__
2436 * does return this character. If it's a subclass
2437 * we must go through the __getitem__ loop */
2438 if (PyString_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002439 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002440 return strobj;
2441 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002442 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002443 if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002444 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002445
Guido van Rossum12d12c51993-10-26 17:58:25 +00002446 for (i = j = 0; i < len; ++i) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002447 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002448 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002449
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002450 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2451 if (item == NULL)
2452 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002453 if (func==Py_None) {
2454 ok = 1;
2455 } else {
2456 PyObject *arg, *good;
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002457 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002458 if (arg == NULL) {
2459 Py_DECREF(item);
2460 goto Fail_1;
2461 }
2462 good = PyEval_CallObject(func, arg);
2463 Py_DECREF(arg);
2464 if (good == NULL) {
2465 Py_DECREF(item);
2466 goto Fail_1;
2467 }
2468 ok = PyObject_IsTrue(good);
2469 Py_DECREF(good);
Tim Peters388ed082001-04-07 20:34:48 +00002470 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002471 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002472 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002473 if (!PyString_Check(item)) {
2474 PyErr_SetString(PyExc_TypeError, "can't filter str to str:"
2475 " __getitem__ returned different type");
2476 Py_DECREF(item);
2477 goto Fail_1;
2478 }
2479 reslen = PyString_GET_SIZE(item);
2480 if (reslen == 1) {
2481 PyString_AS_STRING(result)[j++] =
2482 PyString_AS_STRING(item)[0];
2483 } else {
2484 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002485 Py_ssize_t need = j + reslen + len-i-1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002486 if (need > outlen) {
2487 /* overallocate, to avoid reallocations */
2488 if (need<2*outlen)
2489 need = 2*outlen;
2490 if (_PyString_Resize(&result, need)) {
2491 Py_DECREF(item);
2492 return NULL;
2493 }
2494 outlen = need;
2495 }
2496 memcpy(
2497 PyString_AS_STRING(result) + j,
2498 PyString_AS_STRING(item),
2499 reslen
2500 );
2501 j += reslen;
2502 }
2503 }
Tim Peters388ed082001-04-07 20:34:48 +00002504 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002505 }
2506
Walter Dörwald903f1e02003-02-04 16:28:00 +00002507 if (j < outlen)
Tim Peters5de98422002-04-27 18:44:32 +00002508 _PyString_Resize(&result, j);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002509
Guido van Rossum12d12c51993-10-26 17:58:25 +00002510 return result;
2511
Guido van Rossum12d12c51993-10-26 17:58:25 +00002512Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002513 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002514 return NULL;
2515}
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002516
2517#ifdef Py_USING_UNICODE
2518/* Helper for filter(): filter a Unicode object through a function */
2519
2520static PyObject *
2521filterunicode(PyObject *func, PyObject *strobj)
2522{
2523 PyObject *result;
Martin v. Löwis725507b2006-03-07 12:08:51 +00002524 register Py_ssize_t i, j;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002525 Py_ssize_t len = PyUnicode_GetSize(strobj);
2526 Py_ssize_t outlen = len;
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002527
2528 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002529 /* If it's a real string we can return the original,
2530 * as no character is ever false and __getitem__
2531 * does return this character. If it's a subclass
2532 * we must go through the __getitem__ loop */
2533 if (PyUnicode_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002534 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002535 return strobj;
2536 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002537 }
2538 if ((result = PyUnicode_FromUnicode(NULL, len)) == NULL)
2539 return NULL;
2540
2541 for (i = j = 0; i < len; ++i) {
2542 PyObject *item, *arg, *good;
2543 int ok;
2544
2545 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2546 if (item == NULL)
2547 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002548 if (func == Py_None) {
2549 ok = 1;
2550 } else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002551 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002552 if (arg == NULL) {
2553 Py_DECREF(item);
2554 goto Fail_1;
2555 }
2556 good = PyEval_CallObject(func, arg);
2557 Py_DECREF(arg);
2558 if (good == NULL) {
2559 Py_DECREF(item);
2560 goto Fail_1;
2561 }
2562 ok = PyObject_IsTrue(good);
2563 Py_DECREF(good);
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002564 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002565 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002566 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002567 if (!PyUnicode_Check(item)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002568 PyErr_SetString(PyExc_TypeError,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002569 "can't filter unicode to unicode:"
2570 " __getitem__ returned different type");
Walter Dörwald903f1e02003-02-04 16:28:00 +00002571 Py_DECREF(item);
2572 goto Fail_1;
2573 }
2574 reslen = PyUnicode_GET_SIZE(item);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002575 if (reslen == 1)
Walter Dörwald903f1e02003-02-04 16:28:00 +00002576 PyUnicode_AS_UNICODE(result)[j++] =
2577 PyUnicode_AS_UNICODE(item)[0];
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002578 else {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002579 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002580 Py_ssize_t need = j + reslen + len - i - 1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002581 if (need > outlen) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002582 /* overallocate,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002583 to avoid reallocations */
2584 if (need < 2 * outlen)
2585 need = 2 * outlen;
Jeremy Hylton364f6be2003-09-16 03:17:16 +00002586 if (PyUnicode_Resize(
2587 &result, need) < 0) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002588 Py_DECREF(item);
Walter Dörwald531e0002003-02-04 16:57:49 +00002589 goto Fail_1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002590 }
2591 outlen = need;
2592 }
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002593 memcpy(PyUnicode_AS_UNICODE(result) + j,
2594 PyUnicode_AS_UNICODE(item),
2595 reslen*sizeof(Py_UNICODE));
Walter Dörwald903f1e02003-02-04 16:28:00 +00002596 j += reslen;
2597 }
2598 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002599 Py_DECREF(item);
2600 }
2601
Walter Dörwald903f1e02003-02-04 16:28:00 +00002602 if (j < outlen)
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002603 PyUnicode_Resize(&result, j);
2604
2605 return result;
2606
2607Fail_1:
2608 Py_DECREF(result);
2609 return NULL;
2610}
2611#endif