blob: f82430cba6fbdace0852b25f022d600478ca2e53 [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\
Neal Norwitz85687522006-09-05 01:52:00 +0000610The globals must be a dictionary and locals can be any mapping,\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000611defaulting 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();
Neal Norwitz43bd4db2006-08-12 01:46:42 +0000762 Py_XINCREF(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();
Neal Norwitz43bd4db2006-08-12 01:46:42 +00001193 Py_XINCREF(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 }
Guido van Rossume105f982008-01-23 20:09:39 +00001221 Py_INCREF(keyfunc);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001222 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001223
Tim Petersc3074532001-05-03 07:00:32 +00001224 it = PyObject_GetIter(v);
Guido van Rossume105f982008-01-23 20:09:39 +00001225 if (it == NULL) {
1226 Py_XDECREF(keyfunc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001227 return NULL;
Guido van Rossume105f982008-01-23 20:09:39 +00001228 }
Tim Petersc3074532001-05-03 07:00:32 +00001229
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001230 maxitem = NULL; /* the result */
1231 maxval = NULL; /* the value associated with the result */
Brett Cannon9e635cf2004-12-07 00:25:35 +00001232 while (( item = PyIter_Next(it) )) {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001233 /* get the value from the key function */
1234 if (keyfunc != NULL) {
1235 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1236 if (val == NULL)
1237 goto Fail_it_item;
1238 }
1239 /* no key function; the value is the item */
1240 else {
1241 val = item;
1242 Py_INCREF(val);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001243 }
Tim Petersc3074532001-05-03 07:00:32 +00001244
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001245 /* maximum value and item are unset; set them */
1246 if (maxval == NULL) {
1247 maxitem = item;
1248 maxval = val;
1249 }
1250 /* maximum value and item are set; update them as necessary */
Guido van Rossum2d951851994-08-29 12:52:16 +00001251 else {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001252 int cmp = PyObject_RichCompareBool(val, maxval, op);
1253 if (cmp < 0)
1254 goto Fail_it_item_and_val;
1255 else if (cmp > 0) {
1256 Py_DECREF(maxval);
1257 Py_DECREF(maxitem);
1258 maxval = val;
1259 maxitem = item;
Guido van Rossum53451b32001-01-17 15:47:24 +00001260 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001261 else {
1262 Py_DECREF(item);
1263 Py_DECREF(val);
Guido van Rossumc8b6df91997-05-23 00:06:51 +00001264 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001265 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001266 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001267 if (PyErr_Occurred())
1268 goto Fail_it;
1269 if (maxval == NULL) {
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001270 PyErr_Format(PyExc_ValueError,
1271 "%s() arg is an empty sequence", name);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001272 assert(maxitem == NULL);
1273 }
1274 else
1275 Py_DECREF(maxval);
Tim Petersc3074532001-05-03 07:00:32 +00001276 Py_DECREF(it);
Guido van Rossume105f982008-01-23 20:09:39 +00001277 Py_XDECREF(keyfunc);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001278 return maxitem;
1279
1280Fail_it_item_and_val:
1281 Py_DECREF(val);
1282Fail_it_item:
1283 Py_DECREF(item);
1284Fail_it:
1285 Py_XDECREF(maxval);
1286 Py_XDECREF(maxitem);
1287 Py_DECREF(it);
Guido van Rossume105f982008-01-23 20:09:39 +00001288 Py_XDECREF(keyfunc);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001289 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001290}
1291
Guido van Rossum79f25d91997-04-29 20:08:16 +00001292static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001293builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001294{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001295 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001296}
1297
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001298PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001299"min(iterable[, key=func]) -> value\n\
1300min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001301\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001302With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001303With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001304
1305
Guido van Rossum79f25d91997-04-29 20:08:16 +00001306static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001307builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001308{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001309 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001310}
1311
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001312PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001313"max(iterable[, key=func]) -> value\n\
1314max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001315\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001316With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001317With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001318
1319
Guido van Rossum79f25d91997-04-29 20:08:16 +00001320static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001321builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001322{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001323 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001324 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001325
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001326 if (v == NULL || (nb = v->ob_type->tp_as_number) == NULL ||
1327 nb->nb_oct == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001328 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001329 "oct() argument can't be converted to oct");
1330 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001331 }
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001332 res = (*nb->nb_oct)(v);
1333 if (res && !PyString_Check(res)) {
1334 PyErr_Format(PyExc_TypeError,
1335 "__oct__ returned non-string (type %.200s)",
1336 res->ob_type->tp_name);
1337 Py_DECREF(res);
1338 return NULL;
1339 }
1340 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001341}
1342
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001343PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001344"oct(number) -> string\n\
1345\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001346Return the octal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001347
1348
Guido van Rossum79f25d91997-04-29 20:08:16 +00001349static PyObject *
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00001350builtin_open(PyObject *self, PyObject *args, PyObject *kwds)
1351{
1352 return PyObject_Call((PyObject*)&PyFile_Type, args, kwds);
1353}
1354
1355PyDoc_STRVAR(open_doc,
1356"open(name[, mode[, buffering]]) -> file object\n\
1357\n\
1358Open a file using the file() type, returns a file object.");
1359
1360
1361static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001362builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001363{
Guido van Rossum09095f32000-03-10 23:00:52 +00001364 long ord;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001365 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001366
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001367 if (PyString_Check(obj)) {
1368 size = PyString_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001369 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001370 ord = (long)((unsigned char)*PyString_AS_STRING(obj));
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001371 return PyInt_FromLong(ord);
1372 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001373#ifdef Py_USING_UNICODE
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001374 } else if (PyUnicode_Check(obj)) {
1375 size = PyUnicode_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001376 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001377 ord = (long)*PyUnicode_AS_UNICODE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001378 return PyInt_FromLong(ord);
1379 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001380#endif
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001381 } else {
1382 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001383 "ord() expected string of length 1, but " \
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001384 "%.200s found", obj->ob_type->tp_name);
Guido van Rossum09095f32000-03-10 23:00:52 +00001385 return NULL;
1386 }
1387
Guido van Rossumad991772001-01-12 16:03:05 +00001388 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001389 "ord() expected a character, "
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001390 "but string of length %zd found",
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001391 size);
1392 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001393}
1394
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001395PyDoc_STRVAR(ord_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001396"ord(c) -> integer\n\
1397\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001398Return the integer ordinal of a one-character string.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001399
1400
Guido van Rossum79f25d91997-04-29 20:08:16 +00001401static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001402builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001403{
Guido van Rossum09df08a1998-05-22 00:51:39 +00001404 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001405
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001406 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001407 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +00001408 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001409}
1410
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001411PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001412"pow(x, y[, z]) -> number\n\
1413\n\
1414With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001415equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001416
1417
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001418
1419/* Return number of items in range (lo, hi, step), when arguments are
1420 * PyInt or PyLong objects. step > 0 required. Return a value < 0 if
1421 * & only if the true value is too large to fit in a signed long.
1422 * Arguments MUST return 1 with either PyInt_Check() or
1423 * PyLong_Check(). Return -1 when there is an error.
1424 */
1425static long
1426get_len_of_range_longs(PyObject *lo, PyObject *hi, PyObject *step)
1427{
1428 /* -------------------------------------------------------------
1429 Algorithm is equal to that of get_len_of_range(), but it operates
1430 on PyObjects (which are assumed to be PyLong or PyInt objects).
1431 ---------------------------------------------------------------*/
1432 long n;
1433 PyObject *diff = NULL;
1434 PyObject *one = NULL;
1435 PyObject *tmp1 = NULL, *tmp2 = NULL, *tmp3 = NULL;
1436 /* holds sub-expression evaluations */
1437
1438 /* if (lo >= hi), return length of 0. */
1439 if (PyObject_Compare(lo, hi) >= 0)
1440 return 0;
1441
1442 if ((one = PyLong_FromLong(1L)) == NULL)
1443 goto Fail;
1444
1445 if ((tmp1 = PyNumber_Subtract(hi, lo)) == NULL)
1446 goto Fail;
1447
1448 if ((diff = PyNumber_Subtract(tmp1, one)) == NULL)
1449 goto Fail;
1450
1451 if ((tmp2 = PyNumber_FloorDivide(diff, step)) == NULL)
1452 goto Fail;
1453
1454 if ((tmp3 = PyNumber_Add(tmp2, one)) == NULL)
1455 goto Fail;
1456
1457 n = PyLong_AsLong(tmp3);
1458 if (PyErr_Occurred()) { /* Check for Overflow */
1459 PyErr_Clear();
1460 goto Fail;
1461 }
1462
1463 Py_DECREF(tmp3);
1464 Py_DECREF(tmp2);
1465 Py_DECREF(diff);
1466 Py_DECREF(tmp1);
1467 Py_DECREF(one);
1468 return n;
1469
1470 Fail:
1471 Py_XDECREF(tmp3);
1472 Py_XDECREF(tmp2);
1473 Py_XDECREF(diff);
1474 Py_XDECREF(tmp1);
1475 Py_XDECREF(one);
1476 return -1;
1477}
1478
1479/* An extension of builtin_range() that handles the case when PyLong
1480 * arguments are given. */
1481static PyObject *
1482handle_range_longs(PyObject *self, PyObject *args)
1483{
1484 PyObject *ilow;
Tim Peters874e1f72003-04-13 22:13:08 +00001485 PyObject *ihigh = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001486 PyObject *istep = NULL;
Tim Peters874e1f72003-04-13 22:13:08 +00001487
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001488 PyObject *curnum = NULL;
1489 PyObject *v = NULL;
1490 long bign;
1491 int i, n;
1492 int cmp_result;
1493
Tim Peters874e1f72003-04-13 22:13:08 +00001494 PyObject *zero = PyLong_FromLong(0);
1495
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001496 if (zero == NULL)
1497 return NULL;
1498
Tim Peters874e1f72003-04-13 22:13:08 +00001499 if (!PyArg_UnpackTuple(args, "range", 1, 3, &ilow, &ihigh, &istep)) {
1500 Py_DECREF(zero);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001501 return NULL;
1502 }
1503
Tim Peters874e1f72003-04-13 22:13:08 +00001504 /* Figure out which way we were called, supply defaults, and be
1505 * sure to incref everything so that the decrefs at the end
1506 * are correct.
1507 */
1508 assert(ilow != NULL);
1509 if (ihigh == NULL) {
1510 /* only 1 arg -- it's the upper limit */
1511 ihigh = ilow;
1512 ilow = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001513 }
Tim Peters874e1f72003-04-13 22:13:08 +00001514 assert(ihigh != NULL);
1515 Py_INCREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001516
Tim Peters874e1f72003-04-13 22:13:08 +00001517 /* ihigh correct now; do ilow */
1518 if (ilow == NULL)
1519 ilow = zero;
1520 Py_INCREF(ilow);
1521
1522 /* ilow and ihigh correct now; do istep */
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001523 if (istep == NULL) {
1524 istep = PyLong_FromLong(1L);
1525 if (istep == NULL)
1526 goto Fail;
1527 }
1528 else {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001529 Py_INCREF(istep);
1530 }
1531
Tim Peters874e1f72003-04-13 22:13:08 +00001532 if (!PyInt_Check(ilow) && !PyLong_Check(ilow)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001533 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001534 "range() integer start argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001535 ilow->ob_type->tp_name);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001536 goto Fail;
1537 }
1538
Tim Peters874e1f72003-04-13 22:13:08 +00001539 if (!PyInt_Check(ihigh) && !PyLong_Check(ihigh)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001540 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001541 "range() integer end argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001542 ihigh->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001543 goto Fail;
1544 }
1545
1546 if (!PyInt_Check(istep) && !PyLong_Check(istep)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001547 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001548 "range() integer step argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001549 istep->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001550 goto Fail;
1551 }
1552
1553 if (PyObject_Cmp(istep, zero, &cmp_result) == -1)
1554 goto Fail;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001555 if (cmp_result == 0) {
1556 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001557 "range() step argument must not be zero");
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001558 goto Fail;
1559 }
1560
1561 if (cmp_result > 0)
1562 bign = get_len_of_range_longs(ilow, ihigh, istep);
1563 else {
1564 PyObject *neg_istep = PyNumber_Negative(istep);
1565 if (neg_istep == NULL)
1566 goto Fail;
1567 bign = get_len_of_range_longs(ihigh, ilow, neg_istep);
1568 Py_DECREF(neg_istep);
1569 }
1570
1571 n = (int)bign;
1572 if (bign < 0 || (long)n != bign) {
1573 PyErr_SetString(PyExc_OverflowError,
1574 "range() result has too many items");
1575 goto Fail;
1576 }
1577
1578 v = PyList_New(n);
1579 if (v == NULL)
1580 goto Fail;
1581
1582 curnum = ilow;
1583 Py_INCREF(curnum);
1584
1585 for (i = 0; i < n; i++) {
1586 PyObject *w = PyNumber_Long(curnum);
1587 PyObject *tmp_num;
1588 if (w == NULL)
1589 goto Fail;
1590
1591 PyList_SET_ITEM(v, i, w);
1592
1593 tmp_num = PyNumber_Add(curnum, istep);
1594 if (tmp_num == NULL)
1595 goto Fail;
1596
1597 Py_DECREF(curnum);
1598 curnum = tmp_num;
1599 }
Tim Peters874e1f72003-04-13 22:13:08 +00001600 Py_DECREF(ilow);
1601 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001602 Py_DECREF(istep);
1603 Py_DECREF(zero);
Tim Peters874e1f72003-04-13 22:13:08 +00001604 Py_DECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001605 return v;
1606
1607 Fail:
Tim Peters874e1f72003-04-13 22:13:08 +00001608 Py_DECREF(ilow);
1609 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001610 Py_XDECREF(istep);
Tim Peters874e1f72003-04-13 22:13:08 +00001611 Py_DECREF(zero);
1612 Py_XDECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001613 Py_XDECREF(v);
1614 return NULL;
1615}
1616
Guido van Rossum124eff01999-02-23 16:11:01 +00001617/* Return number of items in range/xrange (lo, hi, step). step > 0
1618 * required. Return a value < 0 if & only if the true value is too
1619 * large to fit in a signed long.
1620 */
1621static long
Thomas Wouterse28c2962000-07-23 22:21:32 +00001622get_len_of_range(long lo, long hi, long step)
Guido van Rossum124eff01999-02-23 16:11:01 +00001623{
1624 /* -------------------------------------------------------------
1625 If lo >= hi, the range is empty.
1626 Else if n values are in the range, the last one is
1627 lo + (n-1)*step, which must be <= hi-1. Rearranging,
1628 n <= (hi - lo - 1)/step + 1, so taking the floor of the RHS gives
1629 the proper value. Since lo < hi in this case, hi-lo-1 >= 0, so
1630 the RHS is non-negative and so truncation is the same as the
1631 floor. Letting M be the largest positive long, the worst case
1632 for the RHS numerator is hi=M, lo=-M-1, and then
1633 hi-lo-1 = M-(-M-1)-1 = 2*M. Therefore unsigned long has enough
1634 precision to compute the RHS exactly.
1635 ---------------------------------------------------------------*/
1636 long n = 0;
1637 if (lo < hi) {
1638 unsigned long uhi = (unsigned long)hi;
1639 unsigned long ulo = (unsigned long)lo;
1640 unsigned long diff = uhi - ulo - 1;
1641 n = (long)(diff / (unsigned long)step + 1);
1642 }
1643 return n;
1644}
1645
Guido van Rossum79f25d91997-04-29 20:08:16 +00001646static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001647builtin_range(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001648{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001649 long ilow = 0, ihigh = 0, istep = 1;
Guido van Rossum124eff01999-02-23 16:11:01 +00001650 long bign;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001651 int i, n;
Guido van Rossum124eff01999-02-23 16:11:01 +00001652
Guido van Rossum79f25d91997-04-29 20:08:16 +00001653 PyObject *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001654
Guido van Rossum79f25d91997-04-29 20:08:16 +00001655 if (PyTuple_Size(args) <= 1) {
1656 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001657 "l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001658 &ihigh)) {
1659 PyErr_Clear();
1660 return handle_range_longs(self, args);
1661 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001662 }
1663 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001664 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001665 "ll|l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001666 &ilow, &ihigh, &istep)) {
1667 PyErr_Clear();
1668 return handle_range_longs(self, args);
1669 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001670 }
1671 if (istep == 0) {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001672 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001673 "range() step argument must not be zero");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001674 return NULL;
1675 }
Guido van Rossum124eff01999-02-23 16:11:01 +00001676 if (istep > 0)
1677 bign = get_len_of_range(ilow, ihigh, istep);
1678 else
1679 bign = get_len_of_range(ihigh, ilow, -istep);
1680 n = (int)bign;
1681 if (bign < 0 || (long)n != bign) {
Guido van Rossume23cde21999-01-12 05:07:47 +00001682 PyErr_SetString(PyExc_OverflowError,
Fred Drake661ea262000-10-24 19:57:45 +00001683 "range() result has too many items");
Guido van Rossume23cde21999-01-12 05:07:47 +00001684 return NULL;
1685 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001686 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001687 if (v == NULL)
1688 return NULL;
1689 for (i = 0; i < n; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001690 PyObject *w = PyInt_FromLong(ilow);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001691 if (w == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001692 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001693 return NULL;
1694 }
Guido van Rossuma937d141998-04-24 18:22:02 +00001695 PyList_SET_ITEM(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001696 ilow += istep;
1697 }
1698 return v;
1699}
1700
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001701PyDoc_STRVAR(range_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001702"range([start,] stop[, step]) -> list of integers\n\
1703\n\
1704Return a list containing an arithmetic progression of integers.\n\
1705range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.\n\
1706When step is given, it specifies the increment (or decrement).\n\
1707For example, range(4) returns [0, 1, 2, 3]. The end point is omitted!\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001708These are exactly the valid indices for a list of 4 elements.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001709
1710
Guido van Rossum79f25d91997-04-29 20:08:16 +00001711static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001712builtin_raw_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001713{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001714 PyObject *v = NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001715 PyObject *fin = PySys_GetObject("stdin");
1716 PyObject *fout = PySys_GetObject("stdout");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001717
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001718 if (!PyArg_UnpackTuple(args, "[raw_]input", 0, 1, &v))
Guido van Rossum3165fe61992-09-25 21:59:05 +00001719 return NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001720
1721 if (fin == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001722 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdin");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001723 return NULL;
1724 }
1725 if (fout == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001726 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdout");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001727 return NULL;
1728 }
1729 if (PyFile_SoftSpace(fout, 0)) {
1730 if (PyFile_WriteString(" ", fout) != 0)
1731 return NULL;
1732 }
Georg Brandl7e3ba2a2006-08-06 08:23:54 +00001733 if (PyFile_AsFile(fin) && PyFile_AsFile(fout)
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001734 && isatty(fileno(PyFile_AsFile(fin)))
1735 && isatty(fileno(PyFile_AsFile(fout)))) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001736 PyObject *po;
Guido van Rossum872537c1995-07-07 22:43:42 +00001737 char *prompt;
1738 char *s;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001739 PyObject *result;
Guido van Rossum872537c1995-07-07 22:43:42 +00001740 if (v != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001741 po = PyObject_Str(v);
Guido van Rossum872537c1995-07-07 22:43:42 +00001742 if (po == NULL)
1743 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001744 prompt = PyString_AsString(po);
Guido van Rossumd9b52081998-06-26 18:25:38 +00001745 if (prompt == NULL)
1746 return NULL;
Guido van Rossum872537c1995-07-07 22:43:42 +00001747 }
1748 else {
1749 po = NULL;
1750 prompt = "";
1751 }
Michael W. Hudson52db5192004-08-02 13:21:09 +00001752 s = PyOS_Readline(PyFile_AsFile(fin), PyFile_AsFile(fout),
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001753 prompt);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001754 Py_XDECREF(po);
Guido van Rossum872537c1995-07-07 22:43:42 +00001755 if (s == NULL) {
Michael W. Hudson30ea2f22004-07-07 17:44:12 +00001756 if (!PyErr_Occurred())
1757 PyErr_SetNone(PyExc_KeyboardInterrupt);
Guido van Rossum872537c1995-07-07 22:43:42 +00001758 return NULL;
1759 }
1760 if (*s == '\0') {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001761 PyErr_SetNone(PyExc_EOFError);
Guido van Rossum872537c1995-07-07 22:43:42 +00001762 result = NULL;
1763 }
1764 else { /* strip trailing '\n' */
Guido van Rossum106f2da2000-06-28 21:12:25 +00001765 size_t len = strlen(s);
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00001766 if (len > PY_SSIZE_T_MAX) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001767 PyErr_SetString(PyExc_OverflowError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001768 "[raw_]input: input too long");
Guido van Rossum106f2da2000-06-28 21:12:25 +00001769 result = NULL;
1770 }
1771 else {
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00001772 result = PyString_FromStringAndSize(s, len-1);
Guido van Rossum106f2da2000-06-28 21:12:25 +00001773 }
Guido van Rossum872537c1995-07-07 22:43:42 +00001774 }
Guido van Rossumb18618d2000-05-03 23:44:39 +00001775 PyMem_FREE(s);
Guido van Rossum872537c1995-07-07 22:43:42 +00001776 return result;
1777 }
Guido van Rossum90933611991-06-07 16:10:43 +00001778 if (v != NULL) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001779 if (PyFile_WriteObject(v, fout, Py_PRINT_RAW) != 0)
Guido van Rossum90933611991-06-07 16:10:43 +00001780 return NULL;
1781 }
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001782 return PyFile_GetLine(fin, -1);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001783}
1784
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001785PyDoc_STRVAR(raw_input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001786"raw_input([prompt]) -> string\n\
1787\n\
1788Read a string from standard input. The trailing newline is stripped.\n\
1789If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
1790On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001791is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001792
1793
Guido van Rossum79f25d91997-04-29 20:08:16 +00001794static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001795builtin_reduce(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +00001796{
Tim Peters15d81ef2001-05-04 04:39:21 +00001797 PyObject *seq, *func, *result = NULL, *it;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001798
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001799 if (!PyArg_UnpackTuple(args, "reduce", 2, 3, &func, &seq, &result))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001800 return NULL;
1801 if (result != NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00001802 Py_INCREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001803
Tim Peters15d81ef2001-05-04 04:39:21 +00001804 it = PyObject_GetIter(seq);
1805 if (it == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001806 PyErr_SetString(PyExc_TypeError,
Tim Peters15d81ef2001-05-04 04:39:21 +00001807 "reduce() arg 2 must support iteration");
1808 Py_XDECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001809 return NULL;
1810 }
1811
Guido van Rossum79f25d91997-04-29 20:08:16 +00001812 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001813 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001814
Tim Peters15d81ef2001-05-04 04:39:21 +00001815 for (;;) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001816 PyObject *op2;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001817
1818 if (args->ob_refcnt > 1) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001819 Py_DECREF(args);
1820 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001821 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001822 }
1823
Tim Peters15d81ef2001-05-04 04:39:21 +00001824 op2 = PyIter_Next(it);
1825 if (op2 == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +00001826 if (PyErr_Occurred())
1827 goto Fail;
1828 break;
Guido van Rossum2d951851994-08-29 12:52:16 +00001829 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001830
Guido van Rossum2d951851994-08-29 12:52:16 +00001831 if (result == NULL)
1832 result = op2;
1833 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001834 PyTuple_SetItem(args, 0, result);
1835 PyTuple_SetItem(args, 1, op2);
1836 if ((result = PyEval_CallObject(func, args)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00001837 goto Fail;
1838 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001839 }
1840
Guido van Rossum79f25d91997-04-29 20:08:16 +00001841 Py_DECREF(args);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001842
Guido van Rossum2d951851994-08-29 12:52:16 +00001843 if (result == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00001844 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +00001845 "reduce() of empty sequence with no initial value");
Guido van Rossum2d951851994-08-29 12:52:16 +00001846
Tim Peters15d81ef2001-05-04 04:39:21 +00001847 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001848 return result;
1849
Guido van Rossum2d951851994-08-29 12:52:16 +00001850Fail:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001851 Py_XDECREF(args);
1852 Py_XDECREF(result);
Tim Peters15d81ef2001-05-04 04:39:21 +00001853 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001854 return NULL;
1855}
1856
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001857PyDoc_STRVAR(reduce_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001858"reduce(function, sequence[, initial]) -> value\n\
1859\n\
1860Apply a function of two arguments cumulatively to the items of a sequence,\n\
1861from left to right, so as to reduce the sequence to a single value.\n\
1862For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates\n\
1863((((1+2)+3)+4)+5). If initial is present, it is placed before the items\n\
1864of the sequence in the calculation, and serves as a default when the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001865sequence is empty.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001866
1867
Guido van Rossum79f25d91997-04-29 20:08:16 +00001868static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001869builtin_reload(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001870{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001871 return PyImport_ReloadModule(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001872}
1873
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001874PyDoc_STRVAR(reload_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001875"reload(module) -> module\n\
1876\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001877Reload the module. The module must have been successfully imported before.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001878
1879
Guido van Rossum79f25d91997-04-29 20:08:16 +00001880static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001881builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00001882{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001883 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00001884}
1885
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001886PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001887"repr(object) -> string\n\
1888\n\
1889Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001890For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001891
1892
Guido van Rossum79f25d91997-04-29 20:08:16 +00001893static PyObject *
Georg Brandlccadf842006-03-31 18:54:53 +00001894builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001895{
Georg Brandlccadf842006-03-31 18:54:53 +00001896 double number;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001897 double f;
1898 int ndigits = 0;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001899 int i;
Georg Brandlccadf842006-03-31 18:54:53 +00001900 static char *kwlist[] = {"number", "ndigits", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001901
Georg Brandlccadf842006-03-31 18:54:53 +00001902 if (!PyArg_ParseTupleAndKeywords(args, kwds, "d|i:round",
1903 kwlist, &number, &ndigits))
1904 return NULL;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001905 f = 1.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001906 i = abs(ndigits);
1907 while (--i >= 0)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001908 f = f*10.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001909 if (ndigits < 0)
Georg Brandlccadf842006-03-31 18:54:53 +00001910 number /= f;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001911 else
Georg Brandlccadf842006-03-31 18:54:53 +00001912 number *= f;
1913 if (number >= 0.0)
1914 number = floor(number + 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001915 else
Georg Brandlccadf842006-03-31 18:54:53 +00001916 number = ceil(number - 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001917 if (ndigits < 0)
Georg Brandlccadf842006-03-31 18:54:53 +00001918 number *= f;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001919 else
Georg Brandlccadf842006-03-31 18:54:53 +00001920 number /= f;
1921 return PyFloat_FromDouble(number);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001922}
1923
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001924PyDoc_STRVAR(round_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001925"round(number[, ndigits]) -> floating point number\n\
1926\n\
1927Round a number to a given precision in decimal digits (default 0 digits).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001928This always returns a floating point number. Precision may be negative.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001929
Raymond Hettinger64958a12003-12-17 20:43:33 +00001930static PyObject *
1931builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
1932{
1933 PyObject *newlist, *v, *seq, *compare=NULL, *keyfunc=NULL, *newargs;
1934 PyObject *callable;
Martin v. Löwis15e62742006-02-27 16:46:16 +00001935 static char *kwlist[] = {"iterable", "cmp", "key", "reverse", 0};
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001936 int reverse;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001937
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001938 /* args 1-4 should match listsort in Objects/listobject.c */
Armin Rigo71d7e702005-09-20 18:13:03 +00001939 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|OOi:sorted",
1940 kwlist, &seq, &compare, &keyfunc, &reverse))
1941 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001942
1943 newlist = PySequence_List(seq);
1944 if (newlist == NULL)
1945 return NULL;
1946
1947 callable = PyObject_GetAttrString(newlist, "sort");
1948 if (callable == NULL) {
1949 Py_DECREF(newlist);
1950 return NULL;
1951 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001952
Raymond Hettinger64958a12003-12-17 20:43:33 +00001953 newargs = PyTuple_GetSlice(args, 1, 4);
1954 if (newargs == NULL) {
1955 Py_DECREF(newlist);
1956 Py_DECREF(callable);
1957 return NULL;
1958 }
1959
1960 v = PyObject_Call(callable, newargs, kwds);
1961 Py_DECREF(newargs);
1962 Py_DECREF(callable);
1963 if (v == NULL) {
1964 Py_DECREF(newlist);
1965 return NULL;
1966 }
1967 Py_DECREF(v);
1968 return newlist;
1969}
1970
1971PyDoc_STRVAR(sorted_doc,
1972"sorted(iterable, cmp=None, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001973
Guido van Rossum79f25d91997-04-29 20:08:16 +00001974static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001975builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00001976{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001977 PyObject *v = NULL;
1978 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001979
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001980 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001981 return NULL;
Guido van Rossum2d951851994-08-29 12:52:16 +00001982 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001983 d = PyEval_GetLocals();
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001984 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001985 if (!PyErr_Occurred())
1986 PyErr_SetString(PyExc_SystemError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001987 "vars(): no locals!?");
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001988 }
1989 else
Guido van Rossum79f25d91997-04-29 20:08:16 +00001990 Py_INCREF(d);
Guido van Rossum2d951851994-08-29 12:52:16 +00001991 }
1992 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001993 d = PyObject_GetAttrString(v, "__dict__");
Guido van Rossum2d951851994-08-29 12:52:16 +00001994 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001995 PyErr_SetString(PyExc_TypeError,
Guido van Rossum2d951851994-08-29 12:52:16 +00001996 "vars() argument must have __dict__ attribute");
1997 return NULL;
1998 }
1999 }
2000 return d;
2001}
2002
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002003PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002004"vars([object]) -> dictionary\n\
2005\n\
2006Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002007With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002008
Alex Martellia70b1912003-04-22 08:12:33 +00002009
2010static PyObject*
2011builtin_sum(PyObject *self, PyObject *args)
2012{
2013 PyObject *seq;
2014 PyObject *result = NULL;
2015 PyObject *temp, *item, *iter;
2016
Raymond Hettinger5cf63942003-10-25 06:41:37 +00002017 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
Alex Martellia70b1912003-04-22 08:12:33 +00002018 return NULL;
2019
2020 iter = PyObject_GetIter(seq);
2021 if (iter == NULL)
2022 return NULL;
2023
2024 if (result == NULL) {
2025 result = PyInt_FromLong(0);
2026 if (result == NULL) {
2027 Py_DECREF(iter);
2028 return NULL;
2029 }
2030 } else {
2031 /* reject string values for 'start' parameter */
2032 if (PyObject_TypeCheck(result, &PyBaseString_Type)) {
2033 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002034 "sum() can't sum strings [use ''.join(seq) instead]");
Alex Martellia70b1912003-04-22 08:12:33 +00002035 Py_DECREF(iter);
2036 return NULL;
2037 }
Alex Martelli41c9f882003-04-22 09:24:48 +00002038 Py_INCREF(result);
Alex Martellia70b1912003-04-22 08:12:33 +00002039 }
2040
2041 for(;;) {
2042 item = PyIter_Next(iter);
2043 if (item == NULL) {
2044 /* error, or end-of-sequence */
2045 if (PyErr_Occurred()) {
2046 Py_DECREF(result);
2047 result = NULL;
2048 }
2049 break;
2050 }
Alex Martellia253e182003-10-25 23:24:14 +00002051 temp = PyNumber_Add(result, item);
Alex Martellia70b1912003-04-22 08:12:33 +00002052 Py_DECREF(result);
2053 Py_DECREF(item);
2054 result = temp;
2055 if (result == NULL)
2056 break;
2057 }
2058 Py_DECREF(iter);
2059 return result;
2060}
2061
2062PyDoc_STRVAR(sum_doc,
2063"sum(sequence, start=0) -> value\n\
2064\n\
2065Returns the sum of a sequence of numbers (NOT strings) plus the value\n\
2066of parameter 'start'. When the sequence is empty, returns start.");
2067
2068
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002069static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002070builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002071{
2072 PyObject *inst;
2073 PyObject *cls;
Guido van Rossum823649d2001-03-21 18:40:58 +00002074 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002075
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002076 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002077 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002078
Guido van Rossum823649d2001-03-21 18:40:58 +00002079 retval = PyObject_IsInstance(inst, cls);
2080 if (retval < 0)
Guido van Rossumad991772001-01-12 16:03:05 +00002081 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002082 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002083}
2084
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002085PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002086"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002087\n\
2088Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002089With a type as second argument, return whether that is the object's type.\n\
2090The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002091isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002092
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002093
2094static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002095builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002096{
2097 PyObject *derived;
2098 PyObject *cls;
2099 int retval;
2100
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002101 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002102 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002103
Guido van Rossum823649d2001-03-21 18:40:58 +00002104 retval = PyObject_IsSubclass(derived, cls);
2105 if (retval < 0)
2106 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002107 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002108}
2109
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002110PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002111"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002112\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002113Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2114When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2115is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002116
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002117
Barry Warsawbd599b52000-08-03 15:45:29 +00002118static PyObject*
2119builtin_zip(PyObject *self, PyObject *args)
2120{
2121 PyObject *ret;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002122 const Py_ssize_t itemsize = PySequence_Length(args);
2123 Py_ssize_t i;
Tim Peters8572b4f2001-05-06 01:05:02 +00002124 PyObject *itlist; /* tuple of iterators */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002125 Py_ssize_t len; /* guess at result length */
Barry Warsawbd599b52000-08-03 15:45:29 +00002126
Raymond Hettingereaef6152003-08-02 07:42:57 +00002127 if (itemsize == 0)
2128 return PyList_New(0);
2129
Barry Warsawbd599b52000-08-03 15:45:29 +00002130 /* args must be a tuple */
2131 assert(PyTuple_Check(args));
2132
Tim Peters39a86c22002-05-12 07:19:38 +00002133 /* Guess at result length: the shortest of the input lengths.
2134 If some argument refuses to say, we refuse to guess too, lest
2135 an argument like xrange(sys.maxint) lead us astray.*/
Tim Peters67d687a2002-04-29 21:27:32 +00002136 len = -1; /* unknown */
2137 for (i = 0; i < itemsize; ++i) {
2138 PyObject *item = PyTuple_GET_ITEM(args, i);
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002139 Py_ssize_t thislen = _PyObject_LengthHint(item);
Tim Peters39a86c22002-05-12 07:19:38 +00002140 if (thislen < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +00002141 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
2142 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
2143 return NULL;
2144 }
Tim Peters67d687a2002-04-29 21:27:32 +00002145 PyErr_Clear();
Tim Peters39a86c22002-05-12 07:19:38 +00002146 len = -1;
2147 break;
2148 }
Tim Peters67d687a2002-04-29 21:27:32 +00002149 else if (len < 0 || thislen < len)
2150 len = thislen;
2151 }
2152
Tim Peters8572b4f2001-05-06 01:05:02 +00002153 /* allocate result list */
Tim Peters67d687a2002-04-29 21:27:32 +00002154 if (len < 0)
2155 len = 10; /* arbitrary */
2156 if ((ret = PyList_New(len)) == NULL)
Barry Warsawbd599b52000-08-03 15:45:29 +00002157 return NULL;
2158
Tim Peters8572b4f2001-05-06 01:05:02 +00002159 /* obtain iterators */
2160 itlist = PyTuple_New(itemsize);
2161 if (itlist == NULL)
2162 goto Fail_ret;
2163 for (i = 0; i < itemsize; ++i) {
2164 PyObject *item = PyTuple_GET_ITEM(args, i);
2165 PyObject *it = PyObject_GetIter(item);
2166 if (it == NULL) {
2167 if (PyErr_ExceptionMatches(PyExc_TypeError))
2168 PyErr_Format(PyExc_TypeError,
Neal Norwitza361bd82006-02-19 19:31:50 +00002169 "zip argument #%zd must support iteration",
Tim Peters8572b4f2001-05-06 01:05:02 +00002170 i+1);
2171 goto Fail_ret_itlist;
Barry Warsawbd599b52000-08-03 15:45:29 +00002172 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002173 PyTuple_SET_ITEM(itlist, i, it);
2174 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002175
Tim Peters8572b4f2001-05-06 01:05:02 +00002176 /* build result into ret list */
Tim Peters67d687a2002-04-29 21:27:32 +00002177 for (i = 0; ; ++i) {
2178 int j;
Tim Peters8572b4f2001-05-06 01:05:02 +00002179 PyObject *next = PyTuple_New(itemsize);
2180 if (!next)
2181 goto Fail_ret_itlist;
2182
Tim Peters67d687a2002-04-29 21:27:32 +00002183 for (j = 0; j < itemsize; j++) {
2184 PyObject *it = PyTuple_GET_ITEM(itlist, j);
Tim Peters8572b4f2001-05-06 01:05:02 +00002185 PyObject *item = PyIter_Next(it);
Barry Warsawbd599b52000-08-03 15:45:29 +00002186 if (!item) {
Tim Peters8572b4f2001-05-06 01:05:02 +00002187 if (PyErr_Occurred()) {
2188 Py_DECREF(ret);
2189 ret = NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002190 }
2191 Py_DECREF(next);
Tim Peters8572b4f2001-05-06 01:05:02 +00002192 Py_DECREF(itlist);
Tim Peters67d687a2002-04-29 21:27:32 +00002193 goto Done;
Barry Warsawbd599b52000-08-03 15:45:29 +00002194 }
Tim Peters67d687a2002-04-29 21:27:32 +00002195 PyTuple_SET_ITEM(next, j, item);
Barry Warsawbd599b52000-08-03 15:45:29 +00002196 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002197
Tim Peters67d687a2002-04-29 21:27:32 +00002198 if (i < len)
2199 PyList_SET_ITEM(ret, i, next);
2200 else {
2201 int status = PyList_Append(ret, next);
2202 Py_DECREF(next);
2203 ++len;
2204 if (status < 0)
2205 goto Fail_ret_itlist;
2206 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002207 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002208
Tim Peters67d687a2002-04-29 21:27:32 +00002209Done:
2210 if (ret != NULL && i < len) {
2211 /* The list is too big. */
2212 if (PyList_SetSlice(ret, i, len, NULL) < 0)
2213 return NULL;
2214 }
2215 return ret;
2216
Tim Peters8572b4f2001-05-06 01:05:02 +00002217Fail_ret_itlist:
2218 Py_DECREF(itlist);
2219Fail_ret:
2220 Py_DECREF(ret);
2221 return NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002222}
2223
2224
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002225PyDoc_STRVAR(zip_doc,
Barry Warsawbd599b52000-08-03 15:45:29 +00002226"zip(seq1 [, seq2 [...]]) -> [(seq1[0], seq2[0] ...), (...)]\n\
2227\n\
2228Return a list of tuples, where each tuple contains the i-th element\n\
2229from each of the argument sequences. The returned list is truncated\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002230in length to the length of the shortest argument sequence.");
Barry Warsawbd599b52000-08-03 15:45:29 +00002231
2232
Guido van Rossum79f25d91997-04-29 20:08:16 +00002233static PyMethodDef builtin_methods[] = {
Neal Norwitz92e212f2006-04-03 04:48:37 +00002234 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002235 {"abs", builtin_abs, METH_O, abs_doc},
Raymond Hettinger96229b12005-03-11 06:49:40 +00002236 {"all", builtin_all, METH_O, all_doc},
2237 {"any", builtin_any, METH_O, any_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002238 {"apply", builtin_apply, METH_VARARGS, apply_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002239 {"callable", builtin_callable, METH_O, callable_doc},
2240 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2241 {"cmp", builtin_cmp, METH_VARARGS, cmp_doc},
2242 {"coerce", builtin_coerce, METH_VARARGS, coerce_doc},
2243 {"compile", builtin_compile, METH_VARARGS, compile_doc},
2244 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2245 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2246 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2247 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2248 {"execfile", builtin_execfile, METH_VARARGS, execfile_doc},
2249 {"filter", builtin_filter, METH_VARARGS, filter_doc},
2250 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2251 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2252 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2253 {"hash", builtin_hash, METH_O, hash_doc},
2254 {"hex", builtin_hex, METH_O, hex_doc},
2255 {"id", builtin_id, METH_O, id_doc},
2256 {"input", builtin_input, METH_VARARGS, input_doc},
2257 {"intern", builtin_intern, METH_VARARGS, intern_doc},
2258 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2259 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2260 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2261 {"len", builtin_len, METH_O, len_doc},
2262 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2263 {"map", builtin_map, METH_VARARGS, map_doc},
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00002264 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2265 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002266 {"oct", builtin_oct, METH_O, oct_doc},
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00002267 {"open", (PyCFunction)builtin_open, METH_VARARGS | METH_KEYWORDS, open_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002268 {"ord", builtin_ord, METH_O, ord_doc},
2269 {"pow", builtin_pow, METH_VARARGS, pow_doc},
2270 {"range", builtin_range, METH_VARARGS, range_doc},
2271 {"raw_input", builtin_raw_input, METH_VARARGS, raw_input_doc},
2272 {"reduce", builtin_reduce, METH_VARARGS, reduce_doc},
2273 {"reload", builtin_reload, METH_O, reload_doc},
2274 {"repr", builtin_repr, METH_O, repr_doc},
Georg Brandlccadf842006-03-31 18:54:53 +00002275 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002276 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
Raymond Hettinger64958a12003-12-17 20:43:33 +00002277 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
Alex Martellia70b1912003-04-22 08:12:33 +00002278 {"sum", builtin_sum, METH_VARARGS, sum_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002279#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002280 {"unichr", builtin_unichr, METH_VARARGS, unichr_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002281#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002282 {"vars", builtin_vars, METH_VARARGS, vars_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002283 {"zip", builtin_zip, METH_VARARGS, zip_doc},
Guido van Rossumc02e15c1991-12-16 13:03:00 +00002284 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002285};
2286
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002287PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002288"Built-in functions, exceptions, and other objects.\n\
2289\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002290Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002291
Guido van Rossum25ce5661997-08-02 03:10:38 +00002292PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002293_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002294{
Fred Drake5550de32000-06-20 04:54:19 +00002295 PyObject *mod, *dict, *debug;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002296 mod = Py_InitModule4("__builtin__", builtin_methods,
2297 builtin_doc, (PyObject *)NULL,
2298 PYTHON_API_VERSION);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002299 if (mod == NULL)
2300 return NULL;
2301 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002302
Tim Peters7571a0f2003-03-23 17:52:28 +00002303#ifdef Py_TRACE_REFS
2304 /* __builtin__ exposes a number of statically allocated objects
2305 * that, before this code was added in 2.3, never showed up in
2306 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2307 * result, programs leaking references to None and False (etc)
2308 * couldn't be diagnosed by examining sys.getobjects(0).
2309 */
2310#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2311#else
2312#define ADD_TO_ALL(OBJECT) (void)0
2313#endif
2314
Tim Peters4b7625e2001-09-13 21:37:17 +00002315#define SETBUILTIN(NAME, OBJECT) \
Tim Peters7571a0f2003-03-23 17:52:28 +00002316 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2317 return NULL; \
2318 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002319
2320 SETBUILTIN("None", Py_None);
2321 SETBUILTIN("Ellipsis", Py_Ellipsis);
2322 SETBUILTIN("NotImplemented", Py_NotImplemented);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002323 SETBUILTIN("False", Py_False);
2324 SETBUILTIN("True", Py_True);
Neal Norwitz32a7e7f2002-05-31 19:58:02 +00002325 SETBUILTIN("basestring", &PyBaseString_Type);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002326 SETBUILTIN("bool", &PyBool_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002327 SETBUILTIN("buffer", &PyBuffer_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002328 SETBUILTIN("classmethod", &PyClassMethod_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002329#ifndef WITHOUT_COMPLEX
Tim Peters4b7625e2001-09-13 21:37:17 +00002330 SETBUILTIN("complex", &PyComplex_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002331#endif
Tim Petersa427a2b2001-10-29 22:25:45 +00002332 SETBUILTIN("dict", &PyDict_Type);
Tim Peters67d687a2002-04-29 21:27:32 +00002333 SETBUILTIN("enumerate", &PyEnum_Type);
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00002334 SETBUILTIN("file", &PyFile_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002335 SETBUILTIN("float", &PyFloat_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002336 SETBUILTIN("frozenset", &PyFrozenSet_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002337 SETBUILTIN("property", &PyProperty_Type);
2338 SETBUILTIN("int", &PyInt_Type);
2339 SETBUILTIN("list", &PyList_Type);
2340 SETBUILTIN("long", &PyLong_Type);
2341 SETBUILTIN("object", &PyBaseObject_Type);
Raymond Hettinger85c20a42003-11-06 14:06:48 +00002342 SETBUILTIN("reversed", &PyReversed_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002343 SETBUILTIN("set", &PySet_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002344 SETBUILTIN("slice", &PySlice_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002345 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2346 SETBUILTIN("str", &PyString_Type);
2347 SETBUILTIN("super", &PySuper_Type);
2348 SETBUILTIN("tuple", &PyTuple_Type);
2349 SETBUILTIN("type", &PyType_Type);
Raymond Hettingerc4c453f2002-06-05 23:12:45 +00002350 SETBUILTIN("xrange", &PyRange_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002351#ifdef Py_USING_UNICODE
Tim Peters4b7625e2001-09-13 21:37:17 +00002352 SETBUILTIN("unicode", &PyUnicode_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002353#endif
Guido van Rossum77f6a652002-04-03 22:41:51 +00002354 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
Fred Drake5550de32000-06-20 04:54:19 +00002355 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2356 Py_XDECREF(debug);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002357 return NULL;
Fred Drake5550de32000-06-20 04:54:19 +00002358 }
2359 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002360
Guido van Rossum25ce5661997-08-02 03:10:38 +00002361 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002362#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002363#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002364}
2365
Guido van Rossume77a7571993-11-03 15:01:26 +00002366/* Helper for filter(): filter a tuple through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002367
Guido van Rossum79f25d91997-04-29 20:08:16 +00002368static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002369filtertuple(PyObject *func, PyObject *tuple)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002370{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002371 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002372 Py_ssize_t i, j;
2373 Py_ssize_t len = PyTuple_Size(tuple);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002374
Guido van Rossumb7b45621995-08-04 04:07:45 +00002375 if (len == 0) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002376 if (PyTuple_CheckExact(tuple))
2377 Py_INCREF(tuple);
2378 else
2379 tuple = PyTuple_New(0);
Guido van Rossumb7b45621995-08-04 04:07:45 +00002380 return tuple;
2381 }
2382
Guido van Rossum79f25d91997-04-29 20:08:16 +00002383 if ((result = PyTuple_New(len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002384 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002385
Guido van Rossum12d12c51993-10-26 17:58:25 +00002386 for (i = j = 0; i < len; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002387 PyObject *item, *good;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002388 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002389
Walter Dörwald8dd19322003-02-10 17:36:40 +00002390 if (tuple->ob_type->tp_as_sequence &&
2391 tuple->ob_type->tp_as_sequence->sq_item) {
2392 item = tuple->ob_type->tp_as_sequence->sq_item(tuple, i);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002393 if (item == NULL)
2394 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002395 } else {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002396 PyErr_SetString(PyExc_TypeError, "filter(): unsubscriptable tuple");
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002397 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002398 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002399 if (func == Py_None) {
2400 Py_INCREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002401 good = item;
2402 }
2403 else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002404 PyObject *arg = PyTuple_Pack(1, item);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002405 if (arg == NULL) {
2406 Py_DECREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002407 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002408 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002409 good = PyEval_CallObject(func, arg);
2410 Py_DECREF(arg);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002411 if (good == NULL) {
2412 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002413 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002414 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002415 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002416 ok = PyObject_IsTrue(good);
2417 Py_DECREF(good);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002418 if (ok) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002419 if (PyTuple_SetItem(result, j++, item) < 0)
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002420 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002421 }
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002422 else
2423 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002424 }
2425
Tim Peters4324aa32001-05-28 22:30:08 +00002426 if (_PyTuple_Resize(&result, j) < 0)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002427 return NULL;
2428
Guido van Rossum12d12c51993-10-26 17:58:25 +00002429 return result;
2430
Guido van Rossum12d12c51993-10-26 17:58:25 +00002431Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002432 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002433 return NULL;
2434}
2435
2436
Guido van Rossume77a7571993-11-03 15:01:26 +00002437/* Helper for filter(): filter a string through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002438
Guido van Rossum79f25d91997-04-29 20:08:16 +00002439static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002440filterstring(PyObject *func, PyObject *strobj)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002441{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002442 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002443 Py_ssize_t i, j;
2444 Py_ssize_t len = PyString_Size(strobj);
2445 Py_ssize_t outlen = len;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002446
Guido van Rossum79f25d91997-04-29 20:08:16 +00002447 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002448 /* If it's a real string we can return the original,
2449 * as no character is ever false and __getitem__
2450 * does return this character. If it's a subclass
2451 * we must go through the __getitem__ loop */
2452 if (PyString_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002453 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002454 return strobj;
2455 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002456 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002457 if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002458 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002459
Guido van Rossum12d12c51993-10-26 17:58:25 +00002460 for (i = j = 0; i < len; ++i) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002461 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002462 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002463
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002464 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2465 if (item == NULL)
2466 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002467 if (func==Py_None) {
2468 ok = 1;
2469 } else {
2470 PyObject *arg, *good;
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002471 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002472 if (arg == NULL) {
2473 Py_DECREF(item);
2474 goto Fail_1;
2475 }
2476 good = PyEval_CallObject(func, arg);
2477 Py_DECREF(arg);
2478 if (good == NULL) {
2479 Py_DECREF(item);
2480 goto Fail_1;
2481 }
2482 ok = PyObject_IsTrue(good);
2483 Py_DECREF(good);
Tim Peters388ed082001-04-07 20:34:48 +00002484 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002485 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002486 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002487 if (!PyString_Check(item)) {
2488 PyErr_SetString(PyExc_TypeError, "can't filter str to str:"
2489 " __getitem__ returned different type");
2490 Py_DECREF(item);
2491 goto Fail_1;
2492 }
2493 reslen = PyString_GET_SIZE(item);
2494 if (reslen == 1) {
2495 PyString_AS_STRING(result)[j++] =
2496 PyString_AS_STRING(item)[0];
2497 } else {
2498 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002499 Py_ssize_t need = j + reslen + len-i-1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002500 if (need > outlen) {
2501 /* overallocate, to avoid reallocations */
2502 if (need<2*outlen)
2503 need = 2*outlen;
2504 if (_PyString_Resize(&result, need)) {
2505 Py_DECREF(item);
2506 return NULL;
2507 }
2508 outlen = need;
2509 }
2510 memcpy(
2511 PyString_AS_STRING(result) + j,
2512 PyString_AS_STRING(item),
2513 reslen
2514 );
2515 j += reslen;
2516 }
2517 }
Tim Peters388ed082001-04-07 20:34:48 +00002518 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002519 }
2520
Walter Dörwald903f1e02003-02-04 16:28:00 +00002521 if (j < outlen)
Tim Peters5de98422002-04-27 18:44:32 +00002522 _PyString_Resize(&result, j);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002523
Guido van Rossum12d12c51993-10-26 17:58:25 +00002524 return result;
2525
Guido van Rossum12d12c51993-10-26 17:58:25 +00002526Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002527 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002528 return NULL;
2529}
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002530
2531#ifdef Py_USING_UNICODE
2532/* Helper for filter(): filter a Unicode object through a function */
2533
2534static PyObject *
2535filterunicode(PyObject *func, PyObject *strobj)
2536{
2537 PyObject *result;
Martin v. Löwis725507b2006-03-07 12:08:51 +00002538 register Py_ssize_t i, j;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002539 Py_ssize_t len = PyUnicode_GetSize(strobj);
2540 Py_ssize_t outlen = len;
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002541
2542 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002543 /* If it's a real string we can return the original,
2544 * as no character is ever false and __getitem__
2545 * does return this character. If it's a subclass
2546 * we must go through the __getitem__ loop */
2547 if (PyUnicode_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002548 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002549 return strobj;
2550 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002551 }
2552 if ((result = PyUnicode_FromUnicode(NULL, len)) == NULL)
2553 return NULL;
2554
2555 for (i = j = 0; i < len; ++i) {
2556 PyObject *item, *arg, *good;
2557 int ok;
2558
2559 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2560 if (item == NULL)
2561 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002562 if (func == Py_None) {
2563 ok = 1;
2564 } else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002565 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002566 if (arg == NULL) {
2567 Py_DECREF(item);
2568 goto Fail_1;
2569 }
2570 good = PyEval_CallObject(func, arg);
2571 Py_DECREF(arg);
2572 if (good == NULL) {
2573 Py_DECREF(item);
2574 goto Fail_1;
2575 }
2576 ok = PyObject_IsTrue(good);
2577 Py_DECREF(good);
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002578 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002579 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002580 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002581 if (!PyUnicode_Check(item)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002582 PyErr_SetString(PyExc_TypeError,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002583 "can't filter unicode to unicode:"
2584 " __getitem__ returned different type");
Walter Dörwald903f1e02003-02-04 16:28:00 +00002585 Py_DECREF(item);
2586 goto Fail_1;
2587 }
2588 reslen = PyUnicode_GET_SIZE(item);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002589 if (reslen == 1)
Walter Dörwald903f1e02003-02-04 16:28:00 +00002590 PyUnicode_AS_UNICODE(result)[j++] =
2591 PyUnicode_AS_UNICODE(item)[0];
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002592 else {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002593 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002594 Py_ssize_t need = j + reslen + len - i - 1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002595 if (need > outlen) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002596 /* overallocate,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002597 to avoid reallocations */
2598 if (need < 2 * outlen)
2599 need = 2 * outlen;
Jeremy Hylton364f6be2003-09-16 03:17:16 +00002600 if (PyUnicode_Resize(
2601 &result, need) < 0) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002602 Py_DECREF(item);
Walter Dörwald531e0002003-02-04 16:57:49 +00002603 goto Fail_1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002604 }
2605 outlen = need;
2606 }
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002607 memcpy(PyUnicode_AS_UNICODE(result) + j,
2608 PyUnicode_AS_UNICODE(item),
2609 reslen*sizeof(Py_UNICODE));
Walter Dörwald903f1e02003-02-04 16:28:00 +00002610 j += reslen;
2611 }
2612 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002613 Py_DECREF(item);
2614 }
2615
Walter Dörwald903f1e02003-02-04 16:28:00 +00002616 if (j < outlen)
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002617 PyUnicode_Resize(&result, j);
2618
2619 return result;
2620
2621Fail_1:
2622 Py_DECREF(result);
2623 return NULL;
2624}
2625#endif