blob: c0607706dcf3ba2bfb6ad7c4953480174193d515 [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"
Georg Brandlfc8eef32008-03-28 12:11:56 +00004#include "Python-ast.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00005
6#include "node.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00007#include "code.h"
Guido van Rossum5b722181993-03-30 17:46:03 +00008#include "eval.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00009
Guido van Rossum6bf62da1997-04-11 20:37:35 +000010#include <ctype.h>
11
Guido van Rossume2ae77b2001-10-24 20:42:55 +000012#ifdef RISCOS
13#include "unixstuff.h"
14#endif
15
Mark Hammond26cffde2001-05-14 12:17:34 +000016/* The default encoding used by the platform file system APIs
17 Can remain NULL for all platforms that don't have such a concept
18*/
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000019#if defined(MS_WINDOWS) && defined(HAVE_USABLE_WCHAR_T)
Mark Hammond26cffde2001-05-14 12:17:34 +000020const char *Py_FileSystemDefaultEncoding = "mbcs";
Just van Rossumb9b8e9c2003-02-10 09:22:01 +000021#elif defined(__APPLE__)
22const char *Py_FileSystemDefaultEncoding = "utf-8";
Mark Hammond26cffde2001-05-14 12:17:34 +000023#else
24const char *Py_FileSystemDefaultEncoding = NULL; /* use default */
25#endif
Mark Hammondef8b6542001-05-13 08:04:26 +000026
Guido van Rossum12d12c51993-10-26 17:58:25 +000027/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +000028static PyObject *filterstring(PyObject *, PyObject *);
Martin v. Löwis8afd7572003-01-25 22:46:11 +000029#ifdef Py_USING_UNICODE
30static PyObject *filterunicode(PyObject *, PyObject *);
31#endif
Tim Petersdbd9ba62000-07-09 03:09:57 +000032static PyObject *filtertuple (PyObject *, PyObject *);
Guido van Rossum12d12c51993-10-26 17:58:25 +000033
Guido van Rossum79f25d91997-04-29 20:08:16 +000034static PyObject *
Neal Norwitz92e212f2006-04-03 04:48:37 +000035builtin___import__(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +000036{
Neal Norwitz92e212f2006-04-03 04:48:37 +000037 static char *kwlist[] = {"name", "globals", "locals", "fromlist",
38 "level", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +000039 char *name;
Guido van Rossum79f25d91997-04-29 20:08:16 +000040 PyObject *globals = NULL;
41 PyObject *locals = NULL;
42 PyObject *fromlist = NULL;
Thomas Woutersf7f438b2006-02-28 16:09:29 +000043 int level = -1;
Guido van Rossum1ae940a1995-01-02 19:04:15 +000044
Neal Norwitz92e212f2006-04-03 04:48:37 +000045 if (!PyArg_ParseTupleAndKeywords(args, kwds, "s|OOOi:__import__",
46 kwlist, &name, &globals, &locals, &fromlist, &level))
Guido van Rossum1ae940a1995-01-02 19:04:15 +000047 return NULL;
Thomas Woutersf7f438b2006-02-28 16:09:29 +000048 return PyImport_ImportModuleLevel(name, globals, locals,
49 fromlist, level);
Guido van Rossum1ae940a1995-01-02 19:04:15 +000050}
51
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000052PyDoc_STRVAR(import_doc,
Neal Norwitz92e212f2006-04-03 04:48:37 +000053"__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000054\n\
55Import a module. The globals are only used to determine the context;\n\
56they are not modified. The locals are currently unused. The fromlist\n\
57should be a list of names to emulate ``from name import ...'', or an\n\
58empty list to emulate ``import name''.\n\
59When importing a module from a package, note that __import__('A.B', ...)\n\
60returns package A when fromlist is empty, but its submodule B when\n\
Neal Norwitz92e212f2006-04-03 04:48:37 +000061fromlist is not empty. Level is used to determine whether to perform \n\
62absolute or relative imports. -1 is the original strategy of attempting\n\
63both absolute and relative imports, 0 is absolute, a positive number\n\
64is the number of parent directories to search relative to the current module.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000065
Guido van Rossum1ae940a1995-01-02 19:04:15 +000066
Guido van Rossum79f25d91997-04-29 20:08:16 +000067static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000068builtin_abs(PyObject *self, PyObject *v)
Guido van Rossum1ae940a1995-01-02 19:04:15 +000069{
Guido van Rossum09df08a1998-05-22 00:51:39 +000070 return PyNumber_Absolute(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +000071}
72
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000073PyDoc_STRVAR(abs_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000074"abs(number) -> number\n\
75\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000076Return the absolute value of the argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000077
Raymond Hettinger96229b12005-03-11 06:49:40 +000078static PyObject *
79builtin_all(PyObject *self, PyObject *v)
80{
81 PyObject *it, *item;
Guido van Rossum01dbc102007-12-20 23:48:28 +000082 PyObject *(*iternext)(PyObject *);
83 int cmp;
Raymond Hettinger96229b12005-03-11 06:49:40 +000084
85 it = PyObject_GetIter(v);
86 if (it == NULL)
87 return NULL;
Guido van Rossum01dbc102007-12-20 23:48:28 +000088 iternext = *Py_TYPE(it)->tp_iternext;
Raymond Hettinger96229b12005-03-11 06:49:40 +000089
Guido van Rossum01dbc102007-12-20 23:48:28 +000090 for (;;) {
91 item = iternext(it);
92 if (item == NULL)
93 break;
94 cmp = PyObject_IsTrue(item);
Raymond Hettinger96229b12005-03-11 06:49:40 +000095 Py_DECREF(item);
96 if (cmp < 0) {
97 Py_DECREF(it);
98 return NULL;
99 }
100 if (cmp == 0) {
101 Py_DECREF(it);
102 Py_RETURN_FALSE;
103 }
104 }
105 Py_DECREF(it);
Guido van Rossum01dbc102007-12-20 23:48:28 +0000106 if (PyErr_Occurred()) {
107 if (PyErr_ExceptionMatches(PyExc_StopIteration))
108 PyErr_Clear();
109 else
110 return NULL;
111 }
Raymond Hettinger96229b12005-03-11 06:49:40 +0000112 Py_RETURN_TRUE;
113}
114
115PyDoc_STRVAR(all_doc,
116"all(iterable) -> bool\n\
117\n\
118Return True if bool(x) is True for all values x in the iterable.");
119
120static PyObject *
121builtin_any(PyObject *self, PyObject *v)
122{
123 PyObject *it, *item;
Guido van Rossum01dbc102007-12-20 23:48:28 +0000124 PyObject *(*iternext)(PyObject *);
125 int cmp;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000126
127 it = PyObject_GetIter(v);
128 if (it == NULL)
129 return NULL;
Guido van Rossum01dbc102007-12-20 23:48:28 +0000130 iternext = *Py_TYPE(it)->tp_iternext;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000131
Guido van Rossum01dbc102007-12-20 23:48:28 +0000132 for (;;) {
133 item = iternext(it);
134 if (item == NULL)
135 break;
136 cmp = PyObject_IsTrue(item);
Raymond Hettinger96229b12005-03-11 06:49:40 +0000137 Py_DECREF(item);
138 if (cmp < 0) {
139 Py_DECREF(it);
140 return NULL;
141 }
142 if (cmp == 1) {
143 Py_DECREF(it);
144 Py_RETURN_TRUE;
145 }
146 }
147 Py_DECREF(it);
Guido van Rossum01dbc102007-12-20 23:48:28 +0000148 if (PyErr_Occurred()) {
149 if (PyErr_ExceptionMatches(PyExc_StopIteration))
150 PyErr_Clear();
151 else
152 return NULL;
153 }
Raymond Hettinger96229b12005-03-11 06:49:40 +0000154 Py_RETURN_FALSE;
155}
156
157PyDoc_STRVAR(any_doc,
158"any(iterable) -> bool\n\
159\n\
160Return True if bool(x) is True for any x in the iterable.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000161
Guido van Rossum79f25d91997-04-29 20:08:16 +0000162static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000163builtin_apply(PyObject *self, PyObject *args)
Guido van Rossumc02e15c1991-12-16 13:03:00 +0000164{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000165 PyObject *func, *alist = NULL, *kwdict = NULL;
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000166 PyObject *t = NULL, *retval = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000167
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000168 if (PyErr_WarnPy3k("apply() not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000169 "use func(*args, **kwargs)", 1) < 0)
Neal Norwitz8b2bfbc2007-05-23 06:35:32 +0000170 return NULL;
171
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000172 if (!PyArg_UnpackTuple(args, "apply", 1, 3, &func, &alist, &kwdict))
Guido van Rossumc02e15c1991-12-16 13:03:00 +0000173 return NULL;
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000174 if (alist != NULL) {
175 if (!PyTuple_Check(alist)) {
176 if (!PySequence_Check(alist)) {
Jeremy Hyltonc862cf42001-01-19 03:25:05 +0000177 PyErr_Format(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000178 "apply() arg 2 expected sequence, found %s",
Jeremy Hyltonc862cf42001-01-19 03:25:05 +0000179 alist->ob_type->tp_name);
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000180 return NULL;
181 }
182 t = PySequence_Tuple(alist);
183 if (t == NULL)
184 return NULL;
185 alist = t;
186 }
Guido van Rossum2d951851994-08-29 12:52:16 +0000187 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000188 if (kwdict != NULL && !PyDict_Check(kwdict)) {
Jeremy Hyltonc862cf42001-01-19 03:25:05 +0000189 PyErr_Format(PyExc_TypeError,
190 "apply() arg 3 expected dictionary, found %s",
191 kwdict->ob_type->tp_name);
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000192 goto finally;
Guido van Rossum681d79a1995-07-18 14:51:37 +0000193 }
Barry Warsaw968f8cb1998-10-01 15:33:12 +0000194 retval = PyEval_CallObjectWithKeywords(func, alist, kwdict);
195 finally:
196 Py_XDECREF(t);
197 return retval;
Guido van Rossumc02e15c1991-12-16 13:03:00 +0000198}
199
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000200PyDoc_STRVAR(apply_doc,
Fred Drakef1fbc622001-01-12 17:05:05 +0000201"apply(object[, args[, kwargs]]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000202\n\
Fred Drake7b912121999-12-23 14:16:55 +0000203Call a callable object with positional arguments taken from the tuple args,\n\
204and keyword arguments taken from the optional dictionary kwargs.\n\
Raymond Hettingerff41c482003-04-06 09:01:11 +0000205Note that classes are callable, as are instances with a __call__() method.\n\
206\n\
207Deprecated since release 2.3. Instead, use the extended call syntax:\n\
208 function(*args, **keywords).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000209
210
Guido van Rossum79f25d91997-04-29 20:08:16 +0000211static PyObject *
Eric Smith3cd81942008-02-22 16:30:22 +0000212builtin_bin(PyObject *self, PyObject *v)
213{
Raymond Hettinger9c437af2008-06-24 22:46:07 +0000214 return PyNumber_ToBase(v, 2);
Eric Smith3cd81942008-02-22 16:30:22 +0000215}
216
217PyDoc_STRVAR(bin_doc,
218"bin(number) -> string\n\
219\n\
220Return the binary representation of an integer or long integer.");
221
222
223static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000224builtin_callable(PyObject *self, PyObject *v)
Guido van Rossum2d951851994-08-29 12:52:16 +0000225{
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000226 if (PyErr_WarnPy3k("callable() not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000227 "use hasattr(o, '__call__')", 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +0000228 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +0000229 return PyBool_FromLong((long)PyCallable_Check(v));
Guido van Rossum2d951851994-08-29 12:52:16 +0000230}
231
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000232PyDoc_STRVAR(callable_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000233"callable(object) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000234\n\
235Return whether the object is callable (i.e., some kind of function).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000236Note that classes are callable, as are instances with a __call__() method.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000237
238
Guido van Rossum79f25d91997-04-29 20:08:16 +0000239static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000240builtin_filter(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000241{
Guido van Rossumc7903a12002-08-16 07:04:56 +0000242 PyObject *func, *seq, *result, *it, *arg;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000243 Py_ssize_t len; /* guess for result list size */
244 register Py_ssize_t j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000245
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000246 if (!PyArg_UnpackTuple(args, "filter", 2, 2, &func, &seq))
Guido van Rossum12d12c51993-10-26 17:58:25 +0000247 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000248
Tim Peters0e57abf2001-05-02 07:39:38 +0000249 /* Strings and tuples return a result of the same type. */
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000250 if (PyString_Check(seq))
Tim Peters0e57abf2001-05-02 07:39:38 +0000251 return filterstring(func, seq);
Martin v. Löwis8afd7572003-01-25 22:46:11 +0000252#ifdef Py_USING_UNICODE
253 if (PyUnicode_Check(seq))
254 return filterunicode(func, seq);
255#endif
Tim Peters0e57abf2001-05-02 07:39:38 +0000256 if (PyTuple_Check(seq))
257 return filtertuple(func, seq);
258
Georg Brandle35b6572005-07-19 22:20:20 +0000259 /* Pre-allocate argument list tuple. */
260 arg = PyTuple_New(1);
261 if (arg == NULL)
262 return NULL;
263
Tim Peters0e57abf2001-05-02 07:39:38 +0000264 /* Get iterator. */
265 it = PyObject_GetIter(seq);
266 if (it == NULL)
Georg Brandle35b6572005-07-19 22:20:20 +0000267 goto Fail_arg;
Tim Peters0e57abf2001-05-02 07:39:38 +0000268
269 /* Guess a result list size. */
Raymond Hettinger4e2f7142007-12-06 00:56:53 +0000270 len = _PyObject_LengthHint(seq, 8);
Raymond Hettingerb5163702009-02-02 21:50:13 +0000271 if (len == -1)
272 goto Fail_it;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000273
Tim Peters0e57abf2001-05-02 07:39:38 +0000274 /* Get a result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000275 if (PyList_Check(seq) && seq->ob_refcnt == 1) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000276 /* Eww - can modify the list in-place. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000277 Py_INCREF(seq);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000278 result = seq;
279 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000280 else {
Tim Peters0e57abf2001-05-02 07:39:38 +0000281 result = PyList_New(len);
282 if (result == NULL)
283 goto Fail_it;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000284 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000285
Tim Peters0e57abf2001-05-02 07:39:38 +0000286 /* Build the result list. */
Tim Petersf4848da2001-05-05 00:14:56 +0000287 j = 0;
288 for (;;) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000289 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000290 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000291
Tim Peters0e57abf2001-05-02 07:39:38 +0000292 item = PyIter_Next(it);
293 if (item == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +0000294 if (PyErr_Occurred())
295 goto Fail_result_it;
Tim Peters0e57abf2001-05-02 07:39:38 +0000296 break;
Guido van Rossum2d951851994-08-29 12:52:16 +0000297 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000298
Neil Schemenauer68973552003-08-14 20:37:34 +0000299 if (func == (PyObject *)&PyBool_Type || func == Py_None) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000300 ok = PyObject_IsTrue(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000301 }
302 else {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000303 PyObject *good;
304 PyTuple_SET_ITEM(arg, 0, item);
305 good = PyObject_Call(func, arg, NULL);
306 PyTuple_SET_ITEM(arg, 0, NULL);
Guido van Rossum58b68731995-01-10 17:40:55 +0000307 if (good == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000308 Py_DECREF(item);
Tim Peters0e57abf2001-05-02 07:39:38 +0000309 goto Fail_result_it;
Guido van Rossum58b68731995-01-10 17:40:55 +0000310 }
Guido van Rossumc7903a12002-08-16 07:04:56 +0000311 ok = PyObject_IsTrue(good);
312 Py_DECREF(good);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000313 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000314 if (ok) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000315 if (j < len)
316 PyList_SET_ITEM(result, j, item);
Guido van Rossum2d951851994-08-29 12:52:16 +0000317 else {
Barry Warsawfa77e091999-01-28 18:49:12 +0000318 int status = PyList_Append(result, item);
Barry Warsawfa77e091999-01-28 18:49:12 +0000319 Py_DECREF(item);
320 if (status < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000321 goto Fail_result_it;
Guido van Rossum2d951851994-08-29 12:52:16 +0000322 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000323 ++j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000324 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000325 else
326 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000327 }
328
Guido van Rossum12d12c51993-10-26 17:58:25 +0000329
Tim Peters0e57abf2001-05-02 07:39:38 +0000330 /* Cut back result list if len is too big. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000331 if (j < len && PyList_SetSlice(result, j, len, NULL) < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000332 goto Fail_result_it;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000333
Tim Peters3c6b1482001-05-21 08:07:05 +0000334 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000335 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000336 return result;
337
Tim Peters0e57abf2001-05-02 07:39:38 +0000338Fail_result_it:
Guido van Rossum79f25d91997-04-29 20:08:16 +0000339 Py_DECREF(result);
Tim Peters0e57abf2001-05-02 07:39:38 +0000340Fail_it:
341 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000342Fail_arg:
343 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000344 return NULL;
345}
346
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000347PyDoc_STRVAR(filter_doc,
Tim Petersd50e5442002-03-09 00:06:26 +0000348"filter(function or None, sequence) -> list, tuple, or string\n"
349"\n"
350"Return those items of sequence for which function(item) is true. If\n"
351"function is None, return the items that are true. If sequence is a tuple\n"
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000352"or string, return the same type, else return a list.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000353
Guido van Rossum79f25d91997-04-29 20:08:16 +0000354static PyObject *
Eric Smitha9f7d622008-02-17 19:46:49 +0000355builtin_format(PyObject *self, PyObject *args)
356{
357 PyObject *value;
358 PyObject *format_spec = NULL;
359
360 if (!PyArg_ParseTuple(args, "O|O:format", &value, &format_spec))
361 return NULL;
362
363 return PyObject_Format(value, format_spec);
364}
365
366PyDoc_STRVAR(format_doc,
367"format(value[, format_spec]) -> string\n\
368\n\
369Returns value.__format__(format_spec)\n\
370format_spec defaults to \"\"");
371
372static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000373builtin_chr(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000374{
375 long x;
376 char s[1];
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000377
Guido van Rossum79f25d91997-04-29 20:08:16 +0000378 if (!PyArg_ParseTuple(args, "l:chr", &x))
Guido van Rossum3f5da241990-12-20 15:06:42 +0000379 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000380 if (x < 0 || x >= 256) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000381 PyErr_SetString(PyExc_ValueError,
382 "chr() arg not in range(256)");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000383 return NULL;
384 }
Guido van Rossum6bf62da1997-04-11 20:37:35 +0000385 s[0] = (char)x;
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000386 return PyString_FromStringAndSize(s, 1);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000387}
388
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000389PyDoc_STRVAR(chr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000390"chr(i) -> character\n\
391\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000392Return a string of one character with ordinal i; 0 <= i < 256.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000393
394
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000395#ifdef Py_USING_UNICODE
Guido van Rossum79f25d91997-04-29 20:08:16 +0000396static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000397builtin_unichr(PyObject *self, PyObject *args)
Guido van Rossum09095f32000-03-10 23:00:52 +0000398{
Amaury Forgeot d'Arc39fd6722008-07-31 21:28:03 +0000399 int x;
Guido van Rossum09095f32000-03-10 23:00:52 +0000400
Amaury Forgeot d'Arc39fd6722008-07-31 21:28:03 +0000401 if (!PyArg_ParseTuple(args, "i:unichr", &x))
Guido van Rossum09095f32000-03-10 23:00:52 +0000402 return NULL;
Fredrik Lundh0dcf67e2001-06-26 20:01:56 +0000403
Marc-André Lemburgcc8764c2002-08-11 12:23:04 +0000404 return PyUnicode_FromOrdinal(x);
Guido van Rossum09095f32000-03-10 23:00:52 +0000405}
406
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000407PyDoc_STRVAR(unichr_doc,
Fred Drake078b24f2000-04-13 02:42:50 +0000408"unichr(i) -> Unicode character\n\
Guido van Rossum09095f32000-03-10 23:00:52 +0000409\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000410Return a Unicode string of one character with ordinal i; 0 <= i <= 0x10ffff.");
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000411#endif
Guido van Rossum09095f32000-03-10 23:00:52 +0000412
413
414static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000415builtin_cmp(PyObject *self, PyObject *args)
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000416{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000417 PyObject *a, *b;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000418 int c;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000419
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000420 if (!PyArg_UnpackTuple(args, "cmp", 2, 2, &a, &b))
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000421 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000422 if (PyObject_Cmp(a, b, &c) < 0)
Guido van Rossumc8b6df91997-05-23 00:06:51 +0000423 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000424 return PyInt_FromLong((long)c);
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000425}
426
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000427PyDoc_STRVAR(cmp_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000428"cmp(x, y) -> integer\n\
429\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000430Return negative if x<y, zero if x==y, positive if x>y.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000431
432
Guido van Rossum79f25d91997-04-29 20:08:16 +0000433static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000434builtin_coerce(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000435{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000436 PyObject *v, *w;
437 PyObject *res;
Guido van Rossum5524a591995-01-10 15:26:20 +0000438
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000439 if (PyErr_WarnPy3k("coerce() not supported in 3.x", 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +0000440 return NULL;
441
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000442 if (!PyArg_UnpackTuple(args, "coerce", 2, 2, &v, &w))
Guido van Rossum5524a591995-01-10 15:26:20 +0000443 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000444 if (PyNumber_Coerce(&v, &w) < 0)
Guido van Rossum04691fc1992-08-12 15:35:34 +0000445 return NULL;
Raymond Hettinger8ae46892003-10-12 19:09:37 +0000446 res = PyTuple_Pack(2, v, w);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000447 Py_DECREF(v);
448 Py_DECREF(w);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000449 return res;
450}
451
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000452PyDoc_STRVAR(coerce_doc,
Martin v. Löwis8d494f32004-08-25 10:42:41 +0000453"coerce(x, y) -> (x1, y1)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000454\n\
Martin v. Löwis8d494f32004-08-25 10:42:41 +0000455Return a tuple consisting of the two numeric arguments converted to\n\
456a common type, using the same rules as used by arithmetic operations.\n\
457If coercion is not possible, raise TypeError.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000458
Guido van Rossum79f25d91997-04-29 20:08:16 +0000459static PyObject *
Georg Brandl5240d742007-03-13 20:46:32 +0000460builtin_compile(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum5b722181993-03-30 17:46:03 +0000461{
462 char *str;
463 char *filename;
464 char *startstr;
Georg Brandlf2bfd542008-03-29 13:24:23 +0000465 int mode = -1;
Tim Peters6cd6a822001-08-17 22:11:27 +0000466 int dont_inherit = 0;
467 int supplied_flags = 0;
Tim Peters5ba58662001-07-16 02:29:45 +0000468 PyCompilerFlags cf;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000469 PyObject *result = NULL, *cmd, *tmp = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000470 Py_ssize_t length;
Georg Brandl5240d742007-03-13 20:46:32 +0000471 static char *kwlist[] = {"source", "filename", "mode", "flags",
472 "dont_inherit", NULL};
Georg Brandlf2bfd542008-03-29 13:24:23 +0000473 int start[] = {Py_file_input, Py_eval_input, Py_single_input};
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000474
Georg Brandl5240d742007-03-13 20:46:32 +0000475 if (!PyArg_ParseTupleAndKeywords(args, kwds, "Oss|ii:compile",
476 kwlist, &cmd, &filename, &startstr,
477 &supplied_flags, &dont_inherit))
Guido van Rossum5b722181993-03-30 17:46:03 +0000478 return NULL;
Tim Peters6cd6a822001-08-17 22:11:27 +0000479
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000480 cf.cf_flags = supplied_flags;
481
Georg Brandlfc8eef32008-03-28 12:11:56 +0000482 if (supplied_flags &
483 ~(PyCF_MASK | PyCF_MASK_OBSOLETE | PyCF_DONT_IMPLY_DEDENT | PyCF_ONLY_AST))
484 {
485 PyErr_SetString(PyExc_ValueError,
486 "compile(): unrecognised flags");
487 return NULL;
488 }
489 /* XXX Warn if (supplied_flags & PyCF_MASK_OBSOLETE) != 0? */
490
491 if (!dont_inherit) {
492 PyEval_MergeCompilerFlags(&cf);
493 }
494
Georg Brandlf2bfd542008-03-29 13:24:23 +0000495 if (strcmp(startstr, "exec") == 0)
496 mode = 0;
497 else if (strcmp(startstr, "eval") == 0)
498 mode = 1;
499 else if (strcmp(startstr, "single") == 0)
500 mode = 2;
501 else {
502 PyErr_SetString(PyExc_ValueError,
503 "compile() arg 3 must be 'exec', 'eval' or 'single'");
504 return NULL;
505 }
506
Georg Brandlfc8eef32008-03-28 12:11:56 +0000507 if (PyAST_Check(cmd)) {
508 if (supplied_flags & PyCF_ONLY_AST) {
509 Py_INCREF(cmd);
510 result = cmd;
511 }
512 else {
513 PyArena *arena;
514 mod_ty mod;
515
516 arena = PyArena_New();
Georg Brandlf2bfd542008-03-29 13:24:23 +0000517 mod = PyAST_obj2mod(cmd, arena, mode);
Georg Brandlfc8eef32008-03-28 12:11:56 +0000518 if (mod == NULL) {
519 PyArena_Free(arena);
520 return NULL;
521 }
522 result = (PyObject*)PyAST_Compile(mod, filename,
523 &cf, arena);
524 PyArena_Free(arena);
525 }
526 return result;
527 }
528
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000529#ifdef Py_USING_UNICODE
530 if (PyUnicode_Check(cmd)) {
531 tmp = PyUnicode_AsUTF8String(cmd);
532 if (tmp == NULL)
533 return NULL;
534 cmd = tmp;
535 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
536 }
537#endif
Tim Peters6cd6a822001-08-17 22:11:27 +0000538
Georg Brandlfc8eef32008-03-28 12:11:56 +0000539 if (PyObject_AsReadBuffer(cmd, (const void **)&str, &length))
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000540 goto cleanup;
Georg Brandlfc8eef32008-03-28 12:11:56 +0000541 if ((size_t)length != strlen(str)) {
542 PyErr_SetString(PyExc_TypeError,
543 "compile() expected string without null bytes");
544 goto cleanup;
Tim Peters6cd6a822001-08-17 22:11:27 +0000545 }
Georg Brandlf2bfd542008-03-29 13:24:23 +0000546 result = Py_CompileStringFlags(str, filename, start[mode], &cf);
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000547cleanup:
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000548 Py_XDECREF(tmp);
549 return result;
Guido van Rossum5b722181993-03-30 17:46:03 +0000550}
551
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000552PyDoc_STRVAR(compile_doc,
Tim Peters6cd6a822001-08-17 22:11:27 +0000553"compile(source, filename, mode[, flags[, dont_inherit]]) -> code object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000554\n\
555Compile the source string (a Python module, statement or expression)\n\
556into a code object that can be executed by the exec statement or eval().\n\
557The filename will be used for run-time error messages.\n\
558The mode must be 'exec' to compile a module, 'single' to compile a\n\
Tim Peters6cd6a822001-08-17 22:11:27 +0000559single (interactive) statement, or 'eval' to compile an expression.\n\
560The flags argument, if present, controls which future statements influence\n\
561the compilation of the code.\n\
562The dont_inherit argument, if non-zero, stops the compilation inheriting\n\
563the effects of any future statements in effect in the code calling\n\
564compile; if absent or zero these statements do influence the compilation,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000565in addition to any features explicitly specified.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000566
Guido van Rossum79f25d91997-04-29 20:08:16 +0000567static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000568builtin_dir(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000569{
Tim Peters5d2b77c2001-09-03 05:47:38 +0000570 PyObject *arg = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000571
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000572 if (!PyArg_UnpackTuple(args, "dir", 0, 1, &arg))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000573 return NULL;
Tim Peters7eea37e2001-09-04 22:08:56 +0000574 return PyObject_Dir(arg);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000575}
576
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000577PyDoc_STRVAR(dir_doc,
Tim Peters5d2b77c2001-09-03 05:47:38 +0000578"dir([object]) -> list of strings\n"
579"\n"
Georg Brandl871f1bc2007-03-12 13:17:36 +0000580"If called without an argument, return the names in the current scope.\n"
581"Else, return an alphabetized list of names comprising (some of) the attributes\n"
582"of the given object, and of attributes reachable from it.\n"
583"If the object supplies a method named __dir__, it will be used; otherwise\n"
584"the default dir() logic is used and returns:\n"
585" for a module object: the module's attributes.\n"
586" for a class object: its attributes, and recursively the attributes\n"
587" of its bases.\n"
Georg Brandl3bb15672007-03-13 07:23:16 +0000588" for any other object: its attributes, its class's attributes, and\n"
Georg Brandl871f1bc2007-03-12 13:17:36 +0000589" recursively the attributes of its class's base classes.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000590
Guido van Rossum79f25d91997-04-29 20:08:16 +0000591static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000592builtin_divmod(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000593{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000594 PyObject *v, *w;
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000595
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000596 if (!PyArg_UnpackTuple(args, "divmod", 2, 2, &v, &w))
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000597 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000598 return PyNumber_Divmod(v, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000599}
600
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000601PyDoc_STRVAR(divmod_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000602"divmod(x, y) -> (div, mod)\n\
603\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000604Return the tuple ((x-x%y)/y, x%y). Invariant: div*y + mod == x.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000605
606
Guido van Rossum79f25d91997-04-29 20:08:16 +0000607static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000608builtin_eval(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000609{
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000610 PyObject *cmd, *result, *tmp = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000611 PyObject *globals = Py_None, *locals = Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000612 char *str;
Tim Peters9fa96be2001-08-17 23:04:59 +0000613 PyCompilerFlags cf;
Guido van Rossum590baa41993-11-30 13:40:46 +0000614
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000615 if (!PyArg_UnpackTuple(args, "eval", 1, 3, &cmd, &globals, &locals))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000616 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000617 if (locals != Py_None && !PyMapping_Check(locals)) {
618 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000619 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000620 }
621 if (globals != Py_None && !PyDict_Check(globals)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +0000622 PyErr_SetString(PyExc_TypeError, PyMapping_Check(globals) ?
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000623 "globals must be a real dict; try eval(expr, {}, mapping)"
624 : "globals must be a dict");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000625 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000626 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000627 if (globals == Py_None) {
628 globals = PyEval_GetGlobals();
629 if (locals == Py_None)
630 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000631 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000632 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000633 locals = globals;
Tim Peters9fa96be2001-08-17 23:04:59 +0000634
Georg Brandl77c85e62005-09-15 10:46:13 +0000635 if (globals == NULL || locals == NULL) {
636 PyErr_SetString(PyExc_TypeError,
637 "eval must be given globals and locals "
638 "when called without a frame");
639 return NULL;
640 }
641
Guido van Rossum79f25d91997-04-29 20:08:16 +0000642 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
643 if (PyDict_SetItemString(globals, "__builtins__",
644 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000645 return NULL;
646 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000647
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000648 if (PyCode_Check(cmd)) {
Jeremy Hylton733c8932001-12-13 19:51:56 +0000649 if (PyCode_GetNumFree((PyCodeObject *)cmd) > 0) {
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000650 PyErr_SetString(PyExc_TypeError,
651 "code object passed to eval() may not contain free variables");
652 return NULL;
653 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000654 return PyEval_EvalCode((PyCodeObject *) cmd, globals, locals);
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000655 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000656
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000657 if (!PyString_Check(cmd) &&
Marc-André Lemburgd1ba4432000-09-19 21:04:18 +0000658 !PyUnicode_Check(cmd)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000659 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +0000660 "eval() arg 1 must be a string or code object");
Guido van Rossum94390a41992-08-14 15:14:30 +0000661 return NULL;
662 }
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000663 cf.cf_flags = 0;
664
665#ifdef Py_USING_UNICODE
666 if (PyUnicode_Check(cmd)) {
667 tmp = PyUnicode_AsUTF8String(cmd);
668 if (tmp == NULL)
669 return NULL;
670 cmd = tmp;
671 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
672 }
673#endif
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000674 if (PyString_AsStringAndSize(cmd, &str, NULL)) {
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000675 Py_XDECREF(tmp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000676 return NULL;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000677 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000678 while (*str == ' ' || *str == '\t')
679 str++;
Tim Peters9fa96be2001-08-17 23:04:59 +0000680
Tim Peters9fa96be2001-08-17 23:04:59 +0000681 (void)PyEval_MergeCompilerFlags(&cf);
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000682 result = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
683 Py_XDECREF(tmp);
684 return result;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000685}
686
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000687PyDoc_STRVAR(eval_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000688"eval(source[, globals[, locals]]) -> value\n\
689\n\
690Evaluate the source in the context of globals and locals.\n\
691The source may be a string representing a Python expression\n\
692or a code object as returned by compile().\n\
Neal Norwitz477ca1c2006-09-05 02:25:41 +0000693The globals must be a dictionary and locals can be any mapping,\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000694defaulting to the current globals and locals.\n\
695If only globals is given, locals defaults to it.\n");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000696
697
Guido van Rossum79f25d91997-04-29 20:08:16 +0000698static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000699builtin_execfile(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000700{
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000701 char *filename;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000702 PyObject *globals = Py_None, *locals = Py_None;
703 PyObject *res;
Guido van Rossumb3a639e2001-09-05 13:37:47 +0000704 FILE* fp = NULL;
Tim Peters5ba58662001-07-16 02:29:45 +0000705 PyCompilerFlags cf;
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000706 int exists;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000707
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000708 if (PyErr_WarnPy3k("execfile() not supported in 3.x; use exec()",
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000709 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +0000710 return NULL;
711
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000712 if (!PyArg_ParseTuple(args, "s|O!O:execfile",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000713 &filename,
Guido van Rossum79f25d91997-04-29 20:08:16 +0000714 &PyDict_Type, &globals,
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000715 &locals))
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000716 return NULL;
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000717 if (locals != Py_None && !PyMapping_Check(locals)) {
718 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
719 return NULL;
720 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000721 if (globals == Py_None) {
722 globals = PyEval_GetGlobals();
723 if (locals == Py_None)
724 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000725 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000726 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000727 locals = globals;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000728 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
729 if (PyDict_SetItemString(globals, "__builtins__",
730 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000731 return NULL;
732 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000733
734 exists = 0;
735 /* Test for existence or directory. */
Martin v. Löwis3484a182002-03-09 12:07:51 +0000736#if defined(PLAN9)
737 {
738 Dir *d;
739
740 if ((d = dirstat(filename))!=nil) {
741 if(d->mode & DMDIR)
742 werrstr("is a directory");
743 else
744 exists = 1;
745 free(d);
746 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000747 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000748#elif defined(RISCOS)
Guido van Rossume2ae77b2001-10-24 20:42:55 +0000749 if (object_exists(filename)) {
750 if (isdir(filename))
751 errno = EISDIR;
752 else
753 exists = 1;
754 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000755#else /* standard Posix */
756 {
757 struct stat s;
758 if (stat(filename, &s) == 0) {
759 if (S_ISDIR(s.st_mode))
Andrew MacIntyreda4d6cb2004-03-29 11:53:38 +0000760# if defined(PYOS_OS2) && defined(PYCC_VACPP)
Martin v. Löwis3484a182002-03-09 12:07:51 +0000761 errno = EOS2ERR;
762# else
763 errno = EISDIR;
764# endif
765 else
766 exists = 1;
767 }
768 }
769#endif
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000770
771 if (exists) {
772 Py_BEGIN_ALLOW_THREADS
Jack Jansen7b8c7542002-04-14 20:12:41 +0000773 fp = fopen(filename, "r" PY_STDIOTEXTMODE);
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000774 Py_END_ALLOW_THREADS
775
776 if (fp == NULL) {
777 exists = 0;
778 }
779 }
780
781 if (!exists) {
Peter Schneider-Kamp4c013422002-08-27 16:58:00 +0000782 PyErr_SetFromErrnoWithFilename(PyExc_IOError, filename);
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000783 return NULL;
784 }
Tim Peters5ba58662001-07-16 02:29:45 +0000785 cf.cf_flags = 0;
786 if (PyEval_MergeCompilerFlags(&cf))
Tim Peters748b8bb2001-04-28 08:20:22 +0000787 res = PyRun_FileExFlags(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000788 locals, 1, &cf);
Tim Peters5ba58662001-07-16 02:29:45 +0000789 else
Tim Peters748b8bb2001-04-28 08:20:22 +0000790 res = PyRun_FileEx(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000791 locals, 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000792 return res;
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000793}
794
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000795PyDoc_STRVAR(execfile_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000796"execfile(filename[, globals[, locals]])\n\
797\n\
798Read and execute a Python script from a file.\n\
799The globals and locals are dictionaries, defaulting to the current\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000800globals and locals. If only globals is given, locals defaults to it.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000801
802
Guido van Rossum79f25d91997-04-29 20:08:16 +0000803static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000804builtin_getattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000805{
Guido van Rossum950ff291998-06-29 13:38:57 +0000806 PyObject *v, *result, *dflt = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000807 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000808
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000809 if (!PyArg_UnpackTuple(args, "getattr", 2, 3, &v, &name, &dflt))
Guido van Rossum33894be1992-01-27 16:53:09 +0000810 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000811#ifdef Py_USING_UNICODE
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000812 if (PyUnicode_Check(name)) {
813 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
814 if (name == NULL)
815 return NULL;
816 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000817#endif
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000818
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000819 if (!PyString_Check(name)) {
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000820 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000821 "getattr(): attribute name must be string");
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000822 return NULL;
823 }
Guido van Rossum950ff291998-06-29 13:38:57 +0000824 result = PyObject_GetAttr(v, name);
Guido van Rossumd8923572001-10-16 21:31:32 +0000825 if (result == NULL && dflt != NULL &&
826 PyErr_ExceptionMatches(PyExc_AttributeError))
827 {
Guido van Rossum950ff291998-06-29 13:38:57 +0000828 PyErr_Clear();
829 Py_INCREF(dflt);
830 result = dflt;
831 }
832 return result;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000833}
834
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000835PyDoc_STRVAR(getattr_doc,
Guido van Rossum950ff291998-06-29 13:38:57 +0000836"getattr(object, name[, default]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000837\n\
Guido van Rossum950ff291998-06-29 13:38:57 +0000838Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
839When a default argument is given, it is returned when the attribute doesn't\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000840exist; without it, an exception is raised in that case.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000841
842
Guido van Rossum79f25d91997-04-29 20:08:16 +0000843static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000844builtin_globals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +0000845{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000846 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000847
Guido van Rossum79f25d91997-04-29 20:08:16 +0000848 d = PyEval_GetGlobals();
Neal Norwitz43bd4db2006-08-12 01:46:42 +0000849 Py_XINCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +0000850 return d;
851}
852
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000853PyDoc_STRVAR(globals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000854"globals() -> dictionary\n\
855\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000856Return the dictionary containing the current scope's global variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000857
858
Guido van Rossum79f25d91997-04-29 20:08:16 +0000859static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000860builtin_hasattr(PyObject *self, PyObject *args)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000861{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000862 PyObject *v;
863 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000864
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000865 if (!PyArg_UnpackTuple(args, "hasattr", 2, 2, &v, &name))
Guido van Rossum9bfef441993-03-29 10:43:31 +0000866 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000867#ifdef Py_USING_UNICODE
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000868 if (PyUnicode_Check(name)) {
869 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
870 if (name == NULL)
871 return NULL;
872 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000873#endif
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000874
Gregory P. Smithdd96db62008-06-09 04:58:54 +0000875 if (!PyString_Check(name)) {
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000876 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000877 "hasattr(): attribute name must be string");
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000878 return NULL;
879 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000880 v = PyObject_GetAttr(v, name);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000881 if (v == NULL) {
Benjamin Petersonb9030f42008-05-12 00:41:23 +0000882 if (!PyErr_ExceptionMatches(PyExc_Exception))
883 return NULL;
884 else {
885 PyErr_Clear();
886 Py_INCREF(Py_False);
887 return Py_False;
888 }
Guido van Rossum9bfef441993-03-29 10:43:31 +0000889 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000890 Py_DECREF(v);
Guido van Rossum09df08a1998-05-22 00:51:39 +0000891 Py_INCREF(Py_True);
892 return Py_True;
Guido van Rossum33894be1992-01-27 16:53:09 +0000893}
894
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000895PyDoc_STRVAR(hasattr_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000896"hasattr(object, name) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000897\n\
898Return whether the object has an attribute with the given name.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000899(This is done by calling getattr(object, name) and catching exceptions.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000900
901
Guido van Rossum79f25d91997-04-29 20:08:16 +0000902static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000903builtin_id(PyObject *self, PyObject *v)
Guido van Rossum5b722181993-03-30 17:46:03 +0000904{
Guido van Rossum106f2da2000-06-28 21:12:25 +0000905 return PyLong_FromVoidPtr(v);
Guido van Rossum5b722181993-03-30 17:46:03 +0000906}
907
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000908PyDoc_STRVAR(id_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000909"id(object) -> integer\n\
910\n\
911Return the identity of an object. This is guaranteed to be unique among\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000912simultaneously existing objects. (Hint: it's the object's memory address.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000913
914
Guido van Rossum79f25d91997-04-29 20:08:16 +0000915static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000916builtin_map(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000917{
918 typedef struct {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000919 PyObject *it; /* the iterator object */
920 int saw_StopIteration; /* bool: did the iterator end? */
Guido van Rossum12d12c51993-10-26 17:58:25 +0000921 } sequence;
922
Guido van Rossum79f25d91997-04-29 20:08:16 +0000923 PyObject *func, *result;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000924 sequence *seqs = NULL, *sqp;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000925 Py_ssize_t n, len;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000926 register int i, j;
927
Guido van Rossum79f25d91997-04-29 20:08:16 +0000928 n = PyTuple_Size(args);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000929 if (n < 2) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000930 PyErr_SetString(PyExc_TypeError,
931 "map() requires at least two args");
Guido van Rossum12d12c51993-10-26 17:58:25 +0000932 return NULL;
933 }
934
Guido van Rossum79f25d91997-04-29 20:08:16 +0000935 func = PyTuple_GetItem(args, 0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000936 n--;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000937
Neal Norwitz53152a12008-02-24 02:20:25 +0000938 if (func == Py_None) {
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000939 if (PyErr_WarnPy3k("map(None, ...) not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000940 "use list(...)", 1) < 0)
Neal Norwitz53152a12008-02-24 02:20:25 +0000941 return NULL;
942 if (n == 1) {
943 /* map(None, S) is the same as list(S). */
944 return PySequence_List(PyTuple_GetItem(args, 1));
945 }
Guido van Rossumfa4ac711998-07-10 17:37:30 +0000946 }
947
Tim Peters4e9afdc2001-05-03 23:54:49 +0000948 /* Get space for sequence descriptors. Must NULL out the iterator
949 * pointers so that jumping to Fail_2 later doesn't see trash.
950 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000951 if ((seqs = PyMem_NEW(sequence, n)) == NULL) {
952 PyErr_NoMemory();
Tim Peters4e9afdc2001-05-03 23:54:49 +0000953 return NULL;
954 }
955 for (i = 0; i < n; ++i) {
956 seqs[i].it = (PyObject*)NULL;
957 seqs[i].saw_StopIteration = 0;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000958 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000959
Tim Peters4e9afdc2001-05-03 23:54:49 +0000960 /* Do a first pass to obtain iterators for the arguments, and set len
961 * to the largest of their lengths.
Tim Peters748b8bb2001-04-28 08:20:22 +0000962 */
Tim Peters4e9afdc2001-05-03 23:54:49 +0000963 len = 0;
964 for (i = 0, sqp = seqs; i < n; ++i, ++sqp) {
965 PyObject *curseq;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000966 Py_ssize_t curlen;
Guido van Rossumad991772001-01-12 16:03:05 +0000967
Tim Peters4e9afdc2001-05-03 23:54:49 +0000968 /* Get iterator. */
969 curseq = PyTuple_GetItem(args, i+1);
970 sqp->it = PyObject_GetIter(curseq);
Benjamin Petersond692a712009-09-07 13:02:15 +0000971 if (sqp->it == NULL) {
972 static char errmsg[] =
973 "argument %d to map() must support iteration";
974 char errbuf[sizeof(errmsg) + 25];
975 PyOS_snprintf(errbuf, sizeof(errbuf), errmsg, i+2);
976 PyErr_SetString(PyExc_TypeError, errbuf);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000977 goto Fail_2;
Benjamin Petersond692a712009-09-07 13:02:15 +0000978 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000979
Tim Peters4e9afdc2001-05-03 23:54:49 +0000980 /* Update len. */
Raymond Hettinger4e2f7142007-12-06 00:56:53 +0000981 curlen = _PyObject_LengthHint(curseq, 8);
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000982 if (curlen > len)
983 len = curlen;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000984 }
985
Tim Peters4e9afdc2001-05-03 23:54:49 +0000986 /* Get space for the result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000987 if ((result = (PyObject *) PyList_New(len)) == NULL)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000988 goto Fail_2;
989
Tim Peters4e9afdc2001-05-03 23:54:49 +0000990 /* Iterate over the sequences until all have stopped. */
Guido van Rossum2d951851994-08-29 12:52:16 +0000991 for (i = 0; ; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000992 PyObject *alist, *item=NULL, *value;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000993 int numactive = 0;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000994
Guido van Rossum79f25d91997-04-29 20:08:16 +0000995 if (func == Py_None && n == 1)
Guido van Rossum32120311995-07-10 13:52:21 +0000996 alist = NULL;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000997 else if ((alist = PyTuple_New(n)) == NULL)
998 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000999
1000 for (j = 0, sqp = seqs; j < n; ++j, ++sqp) {
Tim Peters4e9afdc2001-05-03 23:54:49 +00001001 if (sqp->saw_StopIteration) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001002 Py_INCREF(Py_None);
1003 item = Py_None;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001004 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001005 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +00001006 item = PyIter_Next(sqp->it);
1007 if (item)
1008 ++numactive;
1009 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +00001010 if (PyErr_Occurred()) {
Tim Petersf4848da2001-05-05 00:14:56 +00001011 Py_XDECREF(alist);
1012 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001013 }
Tim Peters4e9afdc2001-05-03 23:54:49 +00001014 Py_INCREF(Py_None);
1015 item = Py_None;
1016 sqp->saw_StopIteration = 1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001017 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001018 }
Tim Peters4e9afdc2001-05-03 23:54:49 +00001019 if (alist)
1020 PyTuple_SET_ITEM(alist, j, item);
1021 else
Guido van Rossum2d951851994-08-29 12:52:16 +00001022 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001023 }
1024
Guido van Rossum32120311995-07-10 13:52:21 +00001025 if (!alist)
1026 alist = item;
Guido van Rossum2d951851994-08-29 12:52:16 +00001027
Tim Peters4e9afdc2001-05-03 23:54:49 +00001028 if (numactive == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001029 Py_DECREF(alist);
Guido van Rossum2d951851994-08-29 12:52:16 +00001030 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001031 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001032
Guido van Rossum79f25d91997-04-29 20:08:16 +00001033 if (func == Py_None)
Guido van Rossum32120311995-07-10 13:52:21 +00001034 value = alist;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001035 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001036 value = PyEval_CallObject(func, alist);
1037 Py_DECREF(alist);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00001038 if (value == NULL)
1039 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001040 }
1041 if (i >= len) {
Barry Warsawfa77e091999-01-28 18:49:12 +00001042 int status = PyList_Append(result, value);
Barry Warsaw21332871999-01-28 04:21:35 +00001043 Py_DECREF(value);
Barry Warsawfa77e091999-01-28 18:49:12 +00001044 if (status < 0)
1045 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001046 }
Tim Peters4e9afdc2001-05-03 23:54:49 +00001047 else if (PyList_SetItem(result, i, value) < 0)
1048 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001049 }
1050
Guido van Rossumfa4ac711998-07-10 17:37:30 +00001051 if (i < len && PyList_SetSlice(result, i, len, NULL) < 0)
1052 goto Fail_1;
1053
Tim Peters4e9afdc2001-05-03 23:54:49 +00001054 goto Succeed;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001055
Guido van Rossum12d12c51993-10-26 17:58:25 +00001056Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001057 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001058Fail_2:
Tim Peters4e9afdc2001-05-03 23:54:49 +00001059 result = NULL;
1060Succeed:
1061 assert(seqs);
1062 for (i = 0; i < n; ++i)
1063 Py_XDECREF(seqs[i].it);
1064 PyMem_DEL(seqs);
1065 return result;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001066}
1067
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001068PyDoc_STRVAR(map_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001069"map(function, sequence[, sequence, ...]) -> list\n\
1070\n\
1071Return a list of the results of applying the function to the items of\n\
1072the argument sequence(s). If more than one sequence is given, the\n\
1073function is called with an argument list consisting of the corresponding\n\
1074item of each sequence, substituting None for missing values when not all\n\
1075sequences have the same length. If the function is None, return a list of\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001076the items of the sequence (or a list of tuples if more than one sequence).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001077
1078
Guido van Rossum79f25d91997-04-29 20:08:16 +00001079static PyObject *
Georg Brandl28e08732008-04-30 19:47:09 +00001080builtin_next(PyObject *self, PyObject *args)
1081{
1082 PyObject *it, *res;
1083 PyObject *def = NULL;
1084
1085 if (!PyArg_UnpackTuple(args, "next", 1, 2, &it, &def))
1086 return NULL;
1087 if (!PyIter_Check(it)) {
1088 PyErr_Format(PyExc_TypeError,
1089 "%.200s object is not an iterator",
1090 it->ob_type->tp_name);
1091 return NULL;
1092 }
1093
1094 res = (*it->ob_type->tp_iternext)(it);
1095 if (res != NULL) {
1096 return res;
1097 } else if (def != NULL) {
1098 if (PyErr_Occurred()) {
1099 if (!PyErr_ExceptionMatches(PyExc_StopIteration))
1100 return NULL;
1101 PyErr_Clear();
1102 }
1103 Py_INCREF(def);
1104 return def;
1105 } else if (PyErr_Occurred()) {
1106 return NULL;
1107 } else {
1108 PyErr_SetNone(PyExc_StopIteration);
1109 return NULL;
1110 }
1111}
1112
1113PyDoc_STRVAR(next_doc,
1114"next(iterator[, default])\n\
1115\n\
1116Return the next item from the iterator. If default is given and the iterator\n\
1117is exhausted, it is returned instead of raising StopIteration.");
1118
1119
1120static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001121builtin_setattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +00001122{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001123 PyObject *v;
1124 PyObject *name;
1125 PyObject *value;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001126
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001127 if (!PyArg_UnpackTuple(args, "setattr", 3, 3, &v, &name, &value))
Guido van Rossum33894be1992-01-27 16:53:09 +00001128 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001129 if (PyObject_SetAttr(v, name, value) != 0)
Guido van Rossum33894be1992-01-27 16:53:09 +00001130 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001131 Py_INCREF(Py_None);
1132 return Py_None;
Guido van Rossum33894be1992-01-27 16:53:09 +00001133}
1134
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001135PyDoc_STRVAR(setattr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001136"setattr(object, name, value)\n\
1137\n\
1138Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001139``x.y = v''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001140
1141
Guido van Rossum79f25d91997-04-29 20:08:16 +00001142static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001143builtin_delattr(PyObject *self, PyObject *args)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001144{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001145 PyObject *v;
1146 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001147
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001148 if (!PyArg_UnpackTuple(args, "delattr", 2, 2, &v, &name))
Guido van Rossum14144fc1994-08-29 12:53:40 +00001149 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001150 if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001151 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001152 Py_INCREF(Py_None);
1153 return Py_None;
Guido van Rossum14144fc1994-08-29 12:53:40 +00001154}
1155
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001156PyDoc_STRVAR(delattr_doc,
Guido van Rossumdf12a591998-11-23 22:13:04 +00001157"delattr(object, name)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001158\n\
1159Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001160``del x.y''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001161
1162
Guido van Rossum79f25d91997-04-29 20:08:16 +00001163static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001164builtin_hash(PyObject *self, PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00001165{
Guido van Rossum9bfef441993-03-29 10:43:31 +00001166 long x;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001167
Guido van Rossum79f25d91997-04-29 20:08:16 +00001168 x = PyObject_Hash(v);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001169 if (x == -1)
1170 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001171 return PyInt_FromLong(x);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001172}
1173
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001174PyDoc_STRVAR(hash_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001175"hash(object) -> integer\n\
1176\n\
1177Return a hash value for the object. Two objects with the same value have\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001178the same hash value. The reverse is not necessarily true, but likely.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001179
1180
Guido van Rossum79f25d91997-04-29 20:08:16 +00001181static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001182builtin_hex(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001183{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001184 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001185 PyObject *res;
Benjamin Petersonc6d64ec2008-05-17 20:09:42 +00001186
1187 if ((nb = v->ob_type->tp_as_number) == NULL ||
1188 nb->nb_hex == NULL) {
1189 PyErr_SetString(PyExc_TypeError,
1190 "hex() argument can't be converted to hex");
1191 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001192 }
Benjamin Petersonc6d64ec2008-05-17 20:09:42 +00001193 res = (*nb->nb_hex)(v);
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001194 if (res && !PyString_Check(res)) {
Benjamin Petersonc6d64ec2008-05-17 20:09:42 +00001195 PyErr_Format(PyExc_TypeError,
1196 "__hex__ returned non-string (type %.200s)",
1197 res->ob_type->tp_name);
1198 Py_DECREF(res);
1199 return NULL;
1200 }
1201 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001202}
1203
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001204PyDoc_STRVAR(hex_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001205"hex(number) -> string\n\
1206\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001207Return the hexadecimal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001208
1209
Tim Petersdbd9ba62000-07-09 03:09:57 +00001210static PyObject *builtin_raw_input(PyObject *, PyObject *);
Guido van Rossum3165fe61992-09-25 21:59:05 +00001211
Guido van Rossum79f25d91997-04-29 20:08:16 +00001212static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001213builtin_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001214{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001215 PyObject *line;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001216 char *str;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001217 PyObject *res;
1218 PyObject *globals, *locals;
Hye-Shik Changff83c2b2004-02-02 13:39:01 +00001219 PyCompilerFlags cf;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001220
1221 line = builtin_raw_input(self, args);
Guido van Rossum3165fe61992-09-25 21:59:05 +00001222 if (line == NULL)
1223 return line;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001224 if (!PyArg_Parse(line, "s;embedded '\\0' in input line", &str))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001225 return NULL;
1226 while (*str == ' ' || *str == '\t')
1227 str++;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001228 globals = PyEval_GetGlobals();
1229 locals = PyEval_GetLocals();
1230 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
1231 if (PyDict_SetItemString(globals, "__builtins__",
1232 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +00001233 return NULL;
1234 }
Hye-Shik Changff83c2b2004-02-02 13:39:01 +00001235 cf.cf_flags = 0;
1236 PyEval_MergeCompilerFlags(&cf);
1237 res = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001238 Py_DECREF(line);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001239 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001240}
1241
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001242PyDoc_STRVAR(input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001243"input([prompt]) -> value\n\
1244\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001245Equivalent to eval(raw_input(prompt)).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001246
1247
Guido van Rossume8811f81997-02-14 15:48:05 +00001248static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001249builtin_intern(PyObject *self, PyObject *args)
Guido van Rossume8811f81997-02-14 15:48:05 +00001250{
1251 PyObject *s;
Guido van Rossum43713e52000-02-29 13:59:29 +00001252 if (!PyArg_ParseTuple(args, "S:intern", &s))
Guido van Rossume8811f81997-02-14 15:48:05 +00001253 return NULL;
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001254 if (!PyString_CheckExact(s)) {
Jeremy Hylton4c989dd2004-08-07 19:20:05 +00001255 PyErr_SetString(PyExc_TypeError,
1256 "can't intern subclass of string");
1257 return NULL;
1258 }
Guido van Rossume8811f81997-02-14 15:48:05 +00001259 Py_INCREF(s);
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001260 PyString_InternInPlace(&s);
Guido van Rossume8811f81997-02-14 15:48:05 +00001261 return s;
1262}
1263
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001264PyDoc_STRVAR(intern_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001265"intern(string) -> string\n\
1266\n\
1267``Intern'' the given string. This enters the string in the (global)\n\
1268table of interned strings whose purpose is to speed up dictionary lookups.\n\
1269Return the string itself or the previously interned string object with the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001270same value.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001271
1272
Guido van Rossum79f25d91997-04-29 20:08:16 +00001273static PyObject *
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001274builtin_iter(PyObject *self, PyObject *args)
1275{
1276 PyObject *v, *w = NULL;
1277
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001278 if (!PyArg_UnpackTuple(args, "iter", 1, 2, &v, &w))
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001279 return NULL;
1280 if (w == NULL)
1281 return PyObject_GetIter(v);
1282 if (!PyCallable_Check(v)) {
1283 PyErr_SetString(PyExc_TypeError,
1284 "iter(v, w): v must be callable");
1285 return NULL;
1286 }
1287 return PyCallIter_New(v, w);
1288}
1289
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001290PyDoc_STRVAR(iter_doc,
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001291"iter(collection) -> iterator\n\
1292iter(callable, sentinel) -> iterator\n\
1293\n\
1294Get an iterator from an object. In the first form, the argument must\n\
1295supply its own iterator, or be a sequence.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001296In the second form, the callable is called until it returns the sentinel.");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001297
1298
1299static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001300builtin_len(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001301{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001302 Py_ssize_t res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001303
Jeremy Hylton03657cf2000-07-12 13:05:33 +00001304 res = PyObject_Size(v);
Guido van Rossum8ea9f4d1998-06-29 22:26:50 +00001305 if (res < 0 && PyErr_Occurred())
1306 return NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001307 return PyInt_FromSsize_t(res);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001308}
1309
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001310PyDoc_STRVAR(len_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001311"len(object) -> integer\n\
1312\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001313Return the number of items of a sequence or mapping.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001314
1315
Guido van Rossum79f25d91997-04-29 20:08:16 +00001316static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001317builtin_locals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +00001318{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001319 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001320
Guido van Rossum79f25d91997-04-29 20:08:16 +00001321 d = PyEval_GetLocals();
Neal Norwitz43bd4db2006-08-12 01:46:42 +00001322 Py_XINCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +00001323 return d;
1324}
1325
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001326PyDoc_STRVAR(locals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001327"locals() -> dictionary\n\
1328\n\
Raymond Hettinger69bf8f32003-01-04 02:16:22 +00001329Update and return a dictionary containing the current scope's local variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001330
1331
Guido van Rossum79f25d91997-04-29 20:08:16 +00001332static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001333min_max(PyObject *args, PyObject *kwds, int op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001334{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001335 PyObject *v, *it, *item, *val, *maxitem, *maxval, *keyfunc=NULL;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001336 const char *name = op == Py_LT ? "min" : "max";
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001337
Guido van Rossum79f25d91997-04-29 20:08:16 +00001338 if (PyTuple_Size(args) > 1)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001339 v = args;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001340 else if (!PyArg_UnpackTuple(args, (char *)name, 1, 1, &v))
Guido van Rossum3f5da241990-12-20 15:06:42 +00001341 return NULL;
Tim Peters67d687a2002-04-29 21:27:32 +00001342
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001343 if (kwds != NULL && PyDict_Check(kwds) && PyDict_Size(kwds)) {
1344 keyfunc = PyDict_GetItemString(kwds, "key");
1345 if (PyDict_Size(kwds)!=1 || keyfunc == NULL) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001346 PyErr_Format(PyExc_TypeError,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001347 "%s() got an unexpected keyword argument", name);
1348 return NULL;
1349 }
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001350 Py_INCREF(keyfunc);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001351 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001352
Tim Petersc3074532001-05-03 07:00:32 +00001353 it = PyObject_GetIter(v);
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001354 if (it == NULL) {
1355 Py_XDECREF(keyfunc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001356 return NULL;
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001357 }
Tim Petersc3074532001-05-03 07:00:32 +00001358
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001359 maxitem = NULL; /* the result */
1360 maxval = NULL; /* the value associated with the result */
Brett Cannon9e635cf2004-12-07 00:25:35 +00001361 while (( item = PyIter_Next(it) )) {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001362 /* get the value from the key function */
1363 if (keyfunc != NULL) {
1364 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1365 if (val == NULL)
1366 goto Fail_it_item;
1367 }
1368 /* no key function; the value is the item */
1369 else {
1370 val = item;
1371 Py_INCREF(val);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001372 }
Tim Petersc3074532001-05-03 07:00:32 +00001373
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001374 /* maximum value and item are unset; set them */
1375 if (maxval == NULL) {
1376 maxitem = item;
1377 maxval = val;
1378 }
1379 /* maximum value and item are set; update them as necessary */
Guido van Rossum2d951851994-08-29 12:52:16 +00001380 else {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001381 int cmp = PyObject_RichCompareBool(val, maxval, op);
1382 if (cmp < 0)
1383 goto Fail_it_item_and_val;
1384 else if (cmp > 0) {
1385 Py_DECREF(maxval);
1386 Py_DECREF(maxitem);
1387 maxval = val;
1388 maxitem = item;
Guido van Rossum53451b32001-01-17 15:47:24 +00001389 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001390 else {
1391 Py_DECREF(item);
1392 Py_DECREF(val);
Guido van Rossumc8b6df91997-05-23 00:06:51 +00001393 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001394 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001395 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001396 if (PyErr_Occurred())
1397 goto Fail_it;
1398 if (maxval == NULL) {
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001399 PyErr_Format(PyExc_ValueError,
1400 "%s() arg is an empty sequence", name);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001401 assert(maxitem == NULL);
1402 }
1403 else
1404 Py_DECREF(maxval);
Tim Petersc3074532001-05-03 07:00:32 +00001405 Py_DECREF(it);
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001406 Py_XDECREF(keyfunc);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001407 return maxitem;
1408
1409Fail_it_item_and_val:
1410 Py_DECREF(val);
1411Fail_it_item:
1412 Py_DECREF(item);
1413Fail_it:
1414 Py_XDECREF(maxval);
1415 Py_XDECREF(maxitem);
1416 Py_DECREF(it);
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001417 Py_XDECREF(keyfunc);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001418 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001419}
1420
Guido van Rossum79f25d91997-04-29 20:08:16 +00001421static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001422builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001423{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001424 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001425}
1426
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001427PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001428"min(iterable[, key=func]) -> value\n\
1429min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001430\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001431With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001432With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001433
1434
Guido van Rossum79f25d91997-04-29 20:08:16 +00001435static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001436builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001437{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001438 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001439}
1440
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001441PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001442"max(iterable[, key=func]) -> value\n\
1443max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001444\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001445With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001446With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001447
1448
Guido van Rossum79f25d91997-04-29 20:08:16 +00001449static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001450builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001451{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001452 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001453 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001454
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001455 if (v == NULL || (nb = v->ob_type->tp_as_number) == NULL ||
1456 nb->nb_oct == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001457 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001458 "oct() argument can't be converted to oct");
1459 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001460 }
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001461 res = (*nb->nb_oct)(v);
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001462 if (res && !PyString_Check(res)) {
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001463 PyErr_Format(PyExc_TypeError,
1464 "__oct__ returned non-string (type %.200s)",
1465 res->ob_type->tp_name);
1466 Py_DECREF(res);
1467 return NULL;
1468 }
1469 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001470}
1471
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001472PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001473"oct(number) -> string\n\
1474\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001475Return the octal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001476
1477
Guido van Rossum79f25d91997-04-29 20:08:16 +00001478static PyObject *
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00001479builtin_open(PyObject *self, PyObject *args, PyObject *kwds)
1480{
1481 return PyObject_Call((PyObject*)&PyFile_Type, args, kwds);
1482}
1483
1484PyDoc_STRVAR(open_doc,
1485"open(name[, mode[, buffering]]) -> file object\n\
1486\n\
Skip Montanaro4e3ebe02007-12-08 14:37:43 +00001487Open a file using the file() type, returns a file object. This is the\n\
Philip Jenveydd0388a2009-05-28 03:12:16 +00001488preferred way to open a file. See file.__doc__ for further information.");
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00001489
1490
1491static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001492builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001493{
Guido van Rossum09095f32000-03-10 23:00:52 +00001494 long ord;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001495 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001496
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001497 if (PyString_Check(obj)) {
1498 size = PyString_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001499 if (size == 1) {
Gregory P. Smithdd96db62008-06-09 04:58:54 +00001500 ord = (long)((unsigned char)*PyString_AS_STRING(obj));
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001501 return PyInt_FromLong(ord);
1502 }
Christian Heimes3497f942008-05-26 12:29:14 +00001503 } else if (PyByteArray_Check(obj)) {
1504 size = PyByteArray_GET_SIZE(obj);
Christian Heimes1a6387e2008-03-26 12:49:49 +00001505 if (size == 1) {
Christian Heimes3497f942008-05-26 12:29:14 +00001506 ord = (long)((unsigned char)*PyByteArray_AS_STRING(obj));
Christian Heimes1a6387e2008-03-26 12:49:49 +00001507 return PyInt_FromLong(ord);
1508 }
1509
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001510#ifdef Py_USING_UNICODE
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001511 } else if (PyUnicode_Check(obj)) {
1512 size = PyUnicode_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001513 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001514 ord = (long)*PyUnicode_AS_UNICODE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001515 return PyInt_FromLong(ord);
1516 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001517#endif
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001518 } else {
1519 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001520 "ord() expected string of length 1, but " \
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001521 "%.200s found", obj->ob_type->tp_name);
Guido van Rossum09095f32000-03-10 23:00:52 +00001522 return NULL;
1523 }
1524
Guido van Rossumad991772001-01-12 16:03:05 +00001525 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001526 "ord() expected a character, "
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001527 "but string of length %zd found",
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001528 size);
1529 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001530}
1531
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001532PyDoc_STRVAR(ord_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001533"ord(c) -> integer\n\
1534\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001535Return the integer ordinal of a one-character string.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001536
1537
Guido van Rossum79f25d91997-04-29 20:08:16 +00001538static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001539builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001540{
Guido van Rossum09df08a1998-05-22 00:51:39 +00001541 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001542
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001543 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001544 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +00001545 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001546}
1547
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001548PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001549"pow(x, y[, z]) -> number\n\
1550\n\
1551With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001552equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001553
1554
Eric Smith7c478942008-03-18 23:45:49 +00001555static PyObject *
1556builtin_print(PyObject *self, PyObject *args, PyObject *kwds)
1557{
1558 static char *kwlist[] = {"sep", "end", "file", 0};
Benjamin Peterson753d1622009-07-02 18:16:45 +00001559 static PyObject *dummy_args = NULL;
1560 static PyObject *unicode_newline = NULL, *unicode_space = NULL;
1561 static PyObject *str_newline = NULL, *str_space = NULL;
1562 PyObject *newline, *space;
Eric Smith7c478942008-03-18 23:45:49 +00001563 PyObject *sep = NULL, *end = NULL, *file = NULL;
Benjamin Peterson753d1622009-07-02 18:16:45 +00001564 int i, err, use_unicode = 0;
Eric Smith7c478942008-03-18 23:45:49 +00001565
1566 if (dummy_args == NULL) {
1567 if (!(dummy_args = PyTuple_New(0)))
1568 return NULL;
1569 }
Benjamin Peterson753d1622009-07-02 18:16:45 +00001570 if (str_newline == NULL) {
1571 str_newline = PyString_FromString("\n");
1572 if (str_newline == NULL)
1573 return NULL;
1574 str_space = PyString_FromString(" ");
1575 if (str_space == NULL) {
1576 Py_CLEAR(str_newline);
1577 return NULL;
1578 }
1579 unicode_newline = PyUnicode_FromString("\n");
1580 if (unicode_newline == NULL) {
1581 Py_CLEAR(str_newline);
1582 Py_CLEAR(str_space);
1583 return NULL;
1584 }
1585 unicode_space = PyUnicode_FromString(" ");
1586 if (unicode_space == NULL) {
1587 Py_CLEAR(str_newline);
1588 Py_CLEAR(str_space);
1589 Py_CLEAR(unicode_space);
1590 return NULL;
1591 }
1592 }
Eric Smith7c478942008-03-18 23:45:49 +00001593 if (!PyArg_ParseTupleAndKeywords(dummy_args, kwds, "|OOO:print",
1594 kwlist, &sep, &end, &file))
1595 return NULL;
1596 if (file == NULL || file == Py_None) {
1597 file = PySys_GetObject("stdout");
1598 /* sys.stdout may be None when FILE* stdout isn't connected */
1599 if (file == Py_None)
1600 Py_RETURN_NONE;
1601 }
Benjamin Peterson753d1622009-07-02 18:16:45 +00001602 if (sep == Py_None) {
1603 sep = NULL;
Eric Smith7c478942008-03-18 23:45:49 +00001604 }
Benjamin Peterson753d1622009-07-02 18:16:45 +00001605 else if (sep) {
1606 if (PyUnicode_Check(sep)) {
1607 use_unicode = 1;
1608 }
1609 else if (!PyString_Check(sep)) {
1610 PyErr_Format(PyExc_TypeError,
1611 "sep must be None, str or unicode, not %.200s",
1612 sep->ob_type->tp_name);
1613 return NULL;
1614 }
1615 }
1616 if (end == Py_None)
1617 end = NULL;
1618 else if (end) {
1619 if (PyUnicode_Check(end)) {
1620 use_unicode = 1;
1621 }
1622 else if (!PyString_Check(end)) {
1623 PyErr_Format(PyExc_TypeError,
1624 "end must be None, str or unicode, not %.200s",
1625 end->ob_type->tp_name);
1626 return NULL;
1627 }
1628 }
1629
1630 if (!use_unicode) {
1631 for (i = 0; i < PyTuple_Size(args); i++) {
1632 if (PyUnicode_Check(PyTuple_GET_ITEM(args, i))) {
1633 use_unicode = 1;
1634 break;
1635 }
1636 }
1637 }
1638 if (use_unicode) {
1639 newline = unicode_newline;
1640 space = unicode_space;
1641 }
1642 else {
1643 newline = str_newline;
1644 space = str_space;
Eric Smith7c478942008-03-18 23:45:49 +00001645 }
1646
1647 for (i = 0; i < PyTuple_Size(args); i++) {
1648 if (i > 0) {
Benjamin Peterson753d1622009-07-02 18:16:45 +00001649 if (sep == NULL)
1650 err = PyFile_WriteObject(space, file,
1651 Py_PRINT_RAW);
Eric Smith7c478942008-03-18 23:45:49 +00001652 else
1653 err = PyFile_WriteObject(sep, file,
1654 Py_PRINT_RAW);
1655 if (err)
1656 return NULL;
1657 }
1658 err = PyFile_WriteObject(PyTuple_GetItem(args, i), file,
1659 Py_PRINT_RAW);
1660 if (err)
1661 return NULL;
1662 }
1663
Benjamin Peterson753d1622009-07-02 18:16:45 +00001664 if (end == NULL)
1665 err = PyFile_WriteObject(newline, file, Py_PRINT_RAW);
Eric Smith7c478942008-03-18 23:45:49 +00001666 else
1667 err = PyFile_WriteObject(end, file, Py_PRINT_RAW);
1668 if (err)
1669 return NULL;
1670
1671 Py_RETURN_NONE;
1672}
1673
1674PyDoc_STRVAR(print_doc,
1675"print(value, ..., sep=' ', end='\\n', file=sys.stdout)\n\
1676\n\
1677Prints the values to a stream, or to sys.stdout by default.\n\
1678Optional keyword arguments:\n\
1679file: a file-like object (stream); defaults to the current sys.stdout.\n\
1680sep: string inserted between values, default a space.\n\
1681end: string appended after the last value, default a newline.");
1682
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001683
1684/* Return number of items in range (lo, hi, step), when arguments are
1685 * PyInt or PyLong objects. step > 0 required. Return a value < 0 if
1686 * & only if the true value is too large to fit in a signed long.
1687 * Arguments MUST return 1 with either PyInt_Check() or
1688 * PyLong_Check(). Return -1 when there is an error.
1689 */
1690static long
1691get_len_of_range_longs(PyObject *lo, PyObject *hi, PyObject *step)
1692{
1693 /* -------------------------------------------------------------
1694 Algorithm is equal to that of get_len_of_range(), but it operates
1695 on PyObjects (which are assumed to be PyLong or PyInt objects).
1696 ---------------------------------------------------------------*/
1697 long n;
1698 PyObject *diff = NULL;
1699 PyObject *one = NULL;
1700 PyObject *tmp1 = NULL, *tmp2 = NULL, *tmp3 = NULL;
1701 /* holds sub-expression evaluations */
1702
1703 /* if (lo >= hi), return length of 0. */
1704 if (PyObject_Compare(lo, hi) >= 0)
1705 return 0;
1706
1707 if ((one = PyLong_FromLong(1L)) == NULL)
1708 goto Fail;
1709
1710 if ((tmp1 = PyNumber_Subtract(hi, lo)) == NULL)
1711 goto Fail;
1712
1713 if ((diff = PyNumber_Subtract(tmp1, one)) == NULL)
1714 goto Fail;
1715
1716 if ((tmp2 = PyNumber_FloorDivide(diff, step)) == NULL)
1717 goto Fail;
1718
1719 if ((tmp3 = PyNumber_Add(tmp2, one)) == NULL)
1720 goto Fail;
1721
1722 n = PyLong_AsLong(tmp3);
1723 if (PyErr_Occurred()) { /* Check for Overflow */
1724 PyErr_Clear();
1725 goto Fail;
1726 }
1727
1728 Py_DECREF(tmp3);
1729 Py_DECREF(tmp2);
1730 Py_DECREF(diff);
1731 Py_DECREF(tmp1);
1732 Py_DECREF(one);
1733 return n;
1734
1735 Fail:
1736 Py_XDECREF(tmp3);
1737 Py_XDECREF(tmp2);
1738 Py_XDECREF(diff);
1739 Py_XDECREF(tmp1);
1740 Py_XDECREF(one);
1741 return -1;
1742}
1743
1744/* An extension of builtin_range() that handles the case when PyLong
1745 * arguments are given. */
1746static PyObject *
1747handle_range_longs(PyObject *self, PyObject *args)
1748{
1749 PyObject *ilow;
Tim Peters874e1f72003-04-13 22:13:08 +00001750 PyObject *ihigh = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001751 PyObject *istep = NULL;
Tim Peters874e1f72003-04-13 22:13:08 +00001752
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001753 PyObject *curnum = NULL;
1754 PyObject *v = NULL;
1755 long bign;
1756 int i, n;
1757 int cmp_result;
1758
Tim Peters874e1f72003-04-13 22:13:08 +00001759 PyObject *zero = PyLong_FromLong(0);
1760
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001761 if (zero == NULL)
1762 return NULL;
1763
Tim Peters874e1f72003-04-13 22:13:08 +00001764 if (!PyArg_UnpackTuple(args, "range", 1, 3, &ilow, &ihigh, &istep)) {
1765 Py_DECREF(zero);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001766 return NULL;
1767 }
1768
Tim Peters874e1f72003-04-13 22:13:08 +00001769 /* Figure out which way we were called, supply defaults, and be
1770 * sure to incref everything so that the decrefs at the end
1771 * are correct.
1772 */
1773 assert(ilow != NULL);
1774 if (ihigh == NULL) {
1775 /* only 1 arg -- it's the upper limit */
1776 ihigh = ilow;
1777 ilow = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001778 }
Tim Peters874e1f72003-04-13 22:13:08 +00001779 assert(ihigh != NULL);
1780 Py_INCREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001781
Tim Peters874e1f72003-04-13 22:13:08 +00001782 /* ihigh correct now; do ilow */
1783 if (ilow == NULL)
1784 ilow = zero;
1785 Py_INCREF(ilow);
1786
1787 /* ilow and ihigh correct now; do istep */
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001788 if (istep == NULL) {
1789 istep = PyLong_FromLong(1L);
1790 if (istep == NULL)
1791 goto Fail;
1792 }
1793 else {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001794 Py_INCREF(istep);
1795 }
1796
Tim Peters874e1f72003-04-13 22:13:08 +00001797 if (!PyInt_Check(ilow) && !PyLong_Check(ilow)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001798 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001799 "range() integer start argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001800 ilow->ob_type->tp_name);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001801 goto Fail;
1802 }
1803
Tim Peters874e1f72003-04-13 22:13:08 +00001804 if (!PyInt_Check(ihigh) && !PyLong_Check(ihigh)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001805 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001806 "range() integer end argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001807 ihigh->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001808 goto Fail;
1809 }
1810
1811 if (!PyInt_Check(istep) && !PyLong_Check(istep)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001812 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001813 "range() integer step argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001814 istep->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001815 goto Fail;
1816 }
1817
1818 if (PyObject_Cmp(istep, zero, &cmp_result) == -1)
1819 goto Fail;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001820 if (cmp_result == 0) {
1821 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001822 "range() step argument must not be zero");
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001823 goto Fail;
1824 }
1825
1826 if (cmp_result > 0)
1827 bign = get_len_of_range_longs(ilow, ihigh, istep);
1828 else {
1829 PyObject *neg_istep = PyNumber_Negative(istep);
1830 if (neg_istep == NULL)
1831 goto Fail;
1832 bign = get_len_of_range_longs(ihigh, ilow, neg_istep);
1833 Py_DECREF(neg_istep);
1834 }
1835
1836 n = (int)bign;
1837 if (bign < 0 || (long)n != bign) {
1838 PyErr_SetString(PyExc_OverflowError,
1839 "range() result has too many items");
1840 goto Fail;
1841 }
1842
1843 v = PyList_New(n);
1844 if (v == NULL)
1845 goto Fail;
1846
1847 curnum = ilow;
1848 Py_INCREF(curnum);
1849
1850 for (i = 0; i < n; i++) {
1851 PyObject *w = PyNumber_Long(curnum);
1852 PyObject *tmp_num;
1853 if (w == NULL)
1854 goto Fail;
1855
1856 PyList_SET_ITEM(v, i, w);
1857
1858 tmp_num = PyNumber_Add(curnum, istep);
1859 if (tmp_num == NULL)
1860 goto Fail;
1861
1862 Py_DECREF(curnum);
1863 curnum = tmp_num;
1864 }
Tim Peters874e1f72003-04-13 22:13:08 +00001865 Py_DECREF(ilow);
1866 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001867 Py_DECREF(istep);
1868 Py_DECREF(zero);
Tim Peters874e1f72003-04-13 22:13:08 +00001869 Py_DECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001870 return v;
1871
1872 Fail:
Tim Peters874e1f72003-04-13 22:13:08 +00001873 Py_DECREF(ilow);
1874 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001875 Py_XDECREF(istep);
Tim Peters874e1f72003-04-13 22:13:08 +00001876 Py_DECREF(zero);
1877 Py_XDECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001878 Py_XDECREF(v);
1879 return NULL;
1880}
1881
Guido van Rossum124eff01999-02-23 16:11:01 +00001882/* Return number of items in range/xrange (lo, hi, step). step > 0
1883 * required. Return a value < 0 if & only if the true value is too
1884 * large to fit in a signed long.
1885 */
1886static long
Thomas Wouterse28c2962000-07-23 22:21:32 +00001887get_len_of_range(long lo, long hi, long step)
Guido van Rossum124eff01999-02-23 16:11:01 +00001888{
1889 /* -------------------------------------------------------------
1890 If lo >= hi, the range is empty.
1891 Else if n values are in the range, the last one is
1892 lo + (n-1)*step, which must be <= hi-1. Rearranging,
1893 n <= (hi - lo - 1)/step + 1, so taking the floor of the RHS gives
1894 the proper value. Since lo < hi in this case, hi-lo-1 >= 0, so
1895 the RHS is non-negative and so truncation is the same as the
1896 floor. Letting M be the largest positive long, the worst case
1897 for the RHS numerator is hi=M, lo=-M-1, and then
1898 hi-lo-1 = M-(-M-1)-1 = 2*M. Therefore unsigned long has enough
1899 precision to compute the RHS exactly.
1900 ---------------------------------------------------------------*/
1901 long n = 0;
1902 if (lo < hi) {
1903 unsigned long uhi = (unsigned long)hi;
1904 unsigned long ulo = (unsigned long)lo;
1905 unsigned long diff = uhi - ulo - 1;
1906 n = (long)(diff / (unsigned long)step + 1);
1907 }
1908 return n;
1909}
1910
Guido van Rossum79f25d91997-04-29 20:08:16 +00001911static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001912builtin_range(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001913{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001914 long ilow = 0, ihigh = 0, istep = 1;
Guido van Rossum124eff01999-02-23 16:11:01 +00001915 long bign;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001916 int i, n;
Guido van Rossum124eff01999-02-23 16:11:01 +00001917
Guido van Rossum79f25d91997-04-29 20:08:16 +00001918 PyObject *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001919
Guido van Rossum79f25d91997-04-29 20:08:16 +00001920 if (PyTuple_Size(args) <= 1) {
1921 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001922 "l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001923 &ihigh)) {
1924 PyErr_Clear();
1925 return handle_range_longs(self, args);
1926 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001927 }
1928 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001929 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001930 "ll|l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001931 &ilow, &ihigh, &istep)) {
1932 PyErr_Clear();
1933 return handle_range_longs(self, args);
1934 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001935 }
1936 if (istep == 0) {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001937 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001938 "range() step argument must not be zero");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001939 return NULL;
1940 }
Guido van Rossum124eff01999-02-23 16:11:01 +00001941 if (istep > 0)
1942 bign = get_len_of_range(ilow, ihigh, istep);
1943 else
1944 bign = get_len_of_range(ihigh, ilow, -istep);
1945 n = (int)bign;
1946 if (bign < 0 || (long)n != bign) {
Guido van Rossume23cde21999-01-12 05:07:47 +00001947 PyErr_SetString(PyExc_OverflowError,
Fred Drake661ea262000-10-24 19:57:45 +00001948 "range() result has too many items");
Guido van Rossume23cde21999-01-12 05:07:47 +00001949 return NULL;
1950 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001951 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001952 if (v == NULL)
1953 return NULL;
1954 for (i = 0; i < n; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001955 PyObject *w = PyInt_FromLong(ilow);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001956 if (w == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001957 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001958 return NULL;
1959 }
Guido van Rossuma937d141998-04-24 18:22:02 +00001960 PyList_SET_ITEM(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001961 ilow += istep;
1962 }
1963 return v;
1964}
1965
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001966PyDoc_STRVAR(range_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001967"range([start,] stop[, step]) -> list of integers\n\
1968\n\
1969Return a list containing an arithmetic progression of integers.\n\
1970range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.\n\
1971When step is given, it specifies the increment (or decrement).\n\
1972For example, range(4) returns [0, 1, 2, 3]. The end point is omitted!\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001973These are exactly the valid indices for a list of 4 elements.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001974
1975
Guido van Rossum79f25d91997-04-29 20:08:16 +00001976static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001977builtin_raw_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001978{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001979 PyObject *v = NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001980 PyObject *fin = PySys_GetObject("stdin");
1981 PyObject *fout = PySys_GetObject("stdout");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001982
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001983 if (!PyArg_UnpackTuple(args, "[raw_]input", 0, 1, &v))
Guido van Rossum3165fe61992-09-25 21:59:05 +00001984 return NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001985
1986 if (fin == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001987 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdin");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001988 return NULL;
1989 }
1990 if (fout == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001991 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdout");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001992 return NULL;
1993 }
1994 if (PyFile_SoftSpace(fout, 0)) {
1995 if (PyFile_WriteString(" ", fout) != 0)
1996 return NULL;
1997 }
Georg Brandl7e3ba2a2006-08-06 08:23:54 +00001998 if (PyFile_AsFile(fin) && PyFile_AsFile(fout)
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001999 && isatty(fileno(PyFile_AsFile(fin)))
2000 && isatty(fileno(PyFile_AsFile(fout)))) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002001 PyObject *po;
Guido van Rossum872537c1995-07-07 22:43:42 +00002002 char *prompt;
2003 char *s;
Guido van Rossum79f25d91997-04-29 20:08:16 +00002004 PyObject *result;
Guido van Rossum872537c1995-07-07 22:43:42 +00002005 if (v != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002006 po = PyObject_Str(v);
Guido van Rossum872537c1995-07-07 22:43:42 +00002007 if (po == NULL)
2008 return NULL;
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002009 prompt = PyString_AsString(po);
Guido van Rossumd9b52081998-06-26 18:25:38 +00002010 if (prompt == NULL)
2011 return NULL;
Guido van Rossum872537c1995-07-07 22:43:42 +00002012 }
2013 else {
2014 po = NULL;
2015 prompt = "";
2016 }
Michael W. Hudson52db5192004-08-02 13:21:09 +00002017 s = PyOS_Readline(PyFile_AsFile(fin), PyFile_AsFile(fout),
Martin v. Löwis566f6af2002-10-26 14:39:10 +00002018 prompt);
Guido van Rossum79f25d91997-04-29 20:08:16 +00002019 Py_XDECREF(po);
Guido van Rossum872537c1995-07-07 22:43:42 +00002020 if (s == NULL) {
Michael W. Hudson30ea2f22004-07-07 17:44:12 +00002021 if (!PyErr_Occurred())
2022 PyErr_SetNone(PyExc_KeyboardInterrupt);
Guido van Rossum872537c1995-07-07 22:43:42 +00002023 return NULL;
2024 }
2025 if (*s == '\0') {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002026 PyErr_SetNone(PyExc_EOFError);
Guido van Rossum872537c1995-07-07 22:43:42 +00002027 result = NULL;
2028 }
2029 else { /* strip trailing '\n' */
Guido van Rossum106f2da2000-06-28 21:12:25 +00002030 size_t len = strlen(s);
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00002031 if (len > PY_SSIZE_T_MAX) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00002032 PyErr_SetString(PyExc_OverflowError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002033 "[raw_]input: input too long");
Guido van Rossum106f2da2000-06-28 21:12:25 +00002034 result = NULL;
2035 }
2036 else {
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002037 result = PyString_FromStringAndSize(s, len-1);
Guido van Rossum106f2da2000-06-28 21:12:25 +00002038 }
Guido van Rossum872537c1995-07-07 22:43:42 +00002039 }
Guido van Rossumb18618d2000-05-03 23:44:39 +00002040 PyMem_FREE(s);
Guido van Rossum872537c1995-07-07 22:43:42 +00002041 return result;
2042 }
Guido van Rossum90933611991-06-07 16:10:43 +00002043 if (v != NULL) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00002044 if (PyFile_WriteObject(v, fout, Py_PRINT_RAW) != 0)
Guido van Rossum90933611991-06-07 16:10:43 +00002045 return NULL;
2046 }
Martin v. Löwis31d2df52002-08-14 15:46:02 +00002047 return PyFile_GetLine(fin, -1);
Guido van Rossum3f5da241990-12-20 15:06:42 +00002048}
2049
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002050PyDoc_STRVAR(raw_input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002051"raw_input([prompt]) -> string\n\
2052\n\
2053Read a string from standard input. The trailing newline is stripped.\n\
2054If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
2055On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002056is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002057
2058
Guido van Rossum79f25d91997-04-29 20:08:16 +00002059static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002060builtin_reduce(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002061{
Benjamin Peterson08336e32008-08-18 02:01:21 +00002062 static PyObject *functools_reduce = NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002063
Benjamin Peterson9f4f4812008-04-27 03:01:45 +00002064 if (PyErr_WarnPy3k("reduce() not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +00002065 "use functools.reduce()", 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +00002066 return NULL;
2067
Benjamin Peterson08336e32008-08-18 02:01:21 +00002068 if (functools_reduce == NULL) {
2069 PyObject *functools = PyImport_ImportModule("functools");
2070 if (functools == NULL)
2071 return NULL;
2072 functools_reduce = PyObject_GetAttrString(functools, "reduce");
2073 Py_DECREF(functools);
2074 if (functools_reduce == NULL)
2075 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002076 }
Benjamin Peterson08336e32008-08-18 02:01:21 +00002077 return PyObject_Call(functools_reduce, args, NULL);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002078}
2079
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002080PyDoc_STRVAR(reduce_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002081"reduce(function, sequence[, initial]) -> value\n\
2082\n\
2083Apply a function of two arguments cumulatively to the items of a sequence,\n\
2084from left to right, so as to reduce the sequence to a single value.\n\
2085For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates\n\
2086((((1+2)+3)+4)+5). If initial is present, it is placed before the items\n\
2087of the sequence in the calculation, and serves as a default when the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002088sequence is empty.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002089
2090
Guido van Rossum79f25d91997-04-29 20:08:16 +00002091static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002092builtin_reload(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00002093{
Benjamin Peterson9f4f4812008-04-27 03:01:45 +00002094 if (PyErr_WarnPy3k("In 3.x, reload() is renamed to imp.reload()",
Benjamin Petersonf19a7b92008-04-27 18:40:21 +00002095 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +00002096 return NULL;
2097
Guido van Rossum79f25d91997-04-29 20:08:16 +00002098 return PyImport_ReloadModule(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00002099}
2100
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002101PyDoc_STRVAR(reload_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002102"reload(module) -> module\n\
2103\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002104Reload the module. The module must have been successfully imported before.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002105
2106
Guido van Rossum79f25d91997-04-29 20:08:16 +00002107static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002108builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00002109{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002110 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00002111}
2112
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002113PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002114"repr(object) -> string\n\
2115\n\
2116Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002117For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002118
2119
Guido van Rossum79f25d91997-04-29 20:08:16 +00002120static PyObject *
Georg Brandlccadf842006-03-31 18:54:53 +00002121builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00002122{
Jeffrey Yasskin9871d8f2008-01-05 08:47:13 +00002123 double number;
2124 double f;
2125 int ndigits = 0;
2126 int i;
Georg Brandlccadf842006-03-31 18:54:53 +00002127 static char *kwlist[] = {"number", "ndigits", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002128
Jeffrey Yasskin9871d8f2008-01-05 08:47:13 +00002129 if (!PyArg_ParseTupleAndKeywords(args, kwds, "d|i:round",
2130 kwlist, &number, &ndigits))
2131 return NULL;
2132 f = 1.0;
2133 i = abs(ndigits);
2134 while (--i >= 0)
2135 f = f*10.0;
2136 if (ndigits < 0)
2137 number /= f;
2138 else
2139 number *= f;
Mark Dickinson1bdf7e92009-04-18 14:59:42 +00002140 number = round(number);
Jeffrey Yasskin9871d8f2008-01-05 08:47:13 +00002141 if (ndigits < 0)
2142 number *= f;
2143 else
2144 number /= f;
2145 return PyFloat_FromDouble(number);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00002146}
2147
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002148PyDoc_STRVAR(round_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002149"round(number[, ndigits]) -> floating point number\n\
2150\n\
2151Round a number to a given precision in decimal digits (default 0 digits).\n\
Jeffrey Yasskin9871d8f2008-01-05 08:47:13 +00002152This always returns a floating point number. Precision may be negative.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002153
Raymond Hettinger64958a12003-12-17 20:43:33 +00002154static PyObject *
2155builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
2156{
2157 PyObject *newlist, *v, *seq, *compare=NULL, *keyfunc=NULL, *newargs;
2158 PyObject *callable;
Martin v. Löwis15e62742006-02-27 16:46:16 +00002159 static char *kwlist[] = {"iterable", "cmp", "key", "reverse", 0};
Neal Norwitz6f0d4792005-12-15 06:40:36 +00002160 int reverse;
Raymond Hettinger64958a12003-12-17 20:43:33 +00002161
Neal Norwitz6f0d4792005-12-15 06:40:36 +00002162 /* args 1-4 should match listsort in Objects/listobject.c */
Armin Rigo71d7e702005-09-20 18:13:03 +00002163 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|OOi:sorted",
2164 kwlist, &seq, &compare, &keyfunc, &reverse))
2165 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00002166
2167 newlist = PySequence_List(seq);
2168 if (newlist == NULL)
2169 return NULL;
2170
2171 callable = PyObject_GetAttrString(newlist, "sort");
2172 if (callable == NULL) {
2173 Py_DECREF(newlist);
2174 return NULL;
2175 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002176
Raymond Hettinger64958a12003-12-17 20:43:33 +00002177 newargs = PyTuple_GetSlice(args, 1, 4);
2178 if (newargs == NULL) {
2179 Py_DECREF(newlist);
2180 Py_DECREF(callable);
2181 return NULL;
2182 }
2183
2184 v = PyObject_Call(callable, newargs, kwds);
2185 Py_DECREF(newargs);
2186 Py_DECREF(callable);
2187 if (v == NULL) {
2188 Py_DECREF(newlist);
2189 return NULL;
2190 }
2191 Py_DECREF(v);
2192 return newlist;
2193}
2194
2195PyDoc_STRVAR(sorted_doc,
2196"sorted(iterable, cmp=None, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002197
Guido van Rossum79f25d91997-04-29 20:08:16 +00002198static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002199builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00002200{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002201 PyObject *v = NULL;
2202 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002203
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002204 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002205 return NULL;
Guido van Rossum2d951851994-08-29 12:52:16 +00002206 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002207 d = PyEval_GetLocals();
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00002208 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002209 if (!PyErr_Occurred())
2210 PyErr_SetString(PyExc_SystemError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002211 "vars(): no locals!?");
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00002212 }
2213 else
Guido van Rossum79f25d91997-04-29 20:08:16 +00002214 Py_INCREF(d);
Guido van Rossum2d951851994-08-29 12:52:16 +00002215 }
2216 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002217 d = PyObject_GetAttrString(v, "__dict__");
Guido van Rossum2d951851994-08-29 12:52:16 +00002218 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002219 PyErr_SetString(PyExc_TypeError,
Guido van Rossum2d951851994-08-29 12:52:16 +00002220 "vars() argument must have __dict__ attribute");
2221 return NULL;
2222 }
2223 }
2224 return d;
2225}
2226
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002227PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002228"vars([object]) -> dictionary\n\
2229\n\
2230Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002231With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002232
Alex Martellia70b1912003-04-22 08:12:33 +00002233
2234static PyObject*
2235builtin_sum(PyObject *self, PyObject *args)
2236{
2237 PyObject *seq;
2238 PyObject *result = NULL;
2239 PyObject *temp, *item, *iter;
2240
Raymond Hettinger5cf63942003-10-25 06:41:37 +00002241 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
Alex Martellia70b1912003-04-22 08:12:33 +00002242 return NULL;
2243
2244 iter = PyObject_GetIter(seq);
2245 if (iter == NULL)
2246 return NULL;
2247
2248 if (result == NULL) {
2249 result = PyInt_FromLong(0);
2250 if (result == NULL) {
2251 Py_DECREF(iter);
2252 return NULL;
2253 }
2254 } else {
2255 /* reject string values for 'start' parameter */
2256 if (PyObject_TypeCheck(result, &PyBaseString_Type)) {
2257 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002258 "sum() can't sum strings [use ''.join(seq) instead]");
Alex Martellia70b1912003-04-22 08:12:33 +00002259 Py_DECREF(iter);
2260 return NULL;
2261 }
Alex Martelli41c9f882003-04-22 09:24:48 +00002262 Py_INCREF(result);
Alex Martellia70b1912003-04-22 08:12:33 +00002263 }
2264
Raymond Hettinger3f8caa32007-10-24 01:28:33 +00002265#ifndef SLOW_SUM
2266 /* Fast addition by keeping temporary sums in C instead of new Python objects.
2267 Assumes all inputs are the same type. If the assumption fails, default
2268 to the more general routine.
2269 */
2270 if (PyInt_CheckExact(result)) {
2271 long i_result = PyInt_AS_LONG(result);
2272 Py_DECREF(result);
2273 result = NULL;
2274 while(result == NULL) {
2275 item = PyIter_Next(iter);
2276 if (item == NULL) {
2277 Py_DECREF(iter);
2278 if (PyErr_Occurred())
2279 return NULL;
2280 return PyInt_FromLong(i_result);
2281 }
2282 if (PyInt_CheckExact(item)) {
2283 long b = PyInt_AS_LONG(item);
2284 long x = i_result + b;
2285 if ((x^i_result) >= 0 || (x^b) >= 0) {
2286 i_result = x;
2287 Py_DECREF(item);
2288 continue;
2289 }
2290 }
2291 /* Either overflowed or is not an int. Restore real objects and process normally */
2292 result = PyInt_FromLong(i_result);
2293 temp = PyNumber_Add(result, item);
2294 Py_DECREF(result);
2295 Py_DECREF(item);
2296 result = temp;
2297 if (result == NULL) {
2298 Py_DECREF(iter);
2299 return NULL;
2300 }
2301 }
2302 }
2303
2304 if (PyFloat_CheckExact(result)) {
2305 double f_result = PyFloat_AS_DOUBLE(result);
2306 Py_DECREF(result);
2307 result = NULL;
2308 while(result == NULL) {
2309 item = PyIter_Next(iter);
2310 if (item == NULL) {
2311 Py_DECREF(iter);
2312 if (PyErr_Occurred())
2313 return NULL;
2314 return PyFloat_FromDouble(f_result);
2315 }
2316 if (PyFloat_CheckExact(item)) {
Raymond Hettinger65856602008-05-30 06:37:27 +00002317 PyFPE_START_PROTECT("add", Py_DECREF(item); Py_DECREF(iter); return 0)
Raymond Hettinger3f8caa32007-10-24 01:28:33 +00002318 f_result += PyFloat_AS_DOUBLE(item);
Raymond Hettinger3a8daf52007-10-24 02:05:51 +00002319 PyFPE_END_PROTECT(f_result)
Raymond Hettingera45c4872007-10-25 02:26:58 +00002320 Py_DECREF(item);
Raymond Hettinger3a8daf52007-10-24 02:05:51 +00002321 continue;
2322 }
2323 if (PyInt_CheckExact(item)) {
Raymond Hettinger65856602008-05-30 06:37:27 +00002324 PyFPE_START_PROTECT("add", Py_DECREF(item); Py_DECREF(iter); return 0)
Raymond Hettinger3a8daf52007-10-24 02:05:51 +00002325 f_result += (double)PyInt_AS_LONG(item);
2326 PyFPE_END_PROTECT(f_result)
Raymond Hettingera45c4872007-10-25 02:26:58 +00002327 Py_DECREF(item);
Raymond Hettinger3f8caa32007-10-24 01:28:33 +00002328 continue;
2329 }
2330 result = PyFloat_FromDouble(f_result);
2331 temp = PyNumber_Add(result, item);
2332 Py_DECREF(result);
2333 Py_DECREF(item);
2334 result = temp;
2335 if (result == NULL) {
2336 Py_DECREF(iter);
2337 return NULL;
2338 }
2339 }
2340 }
2341#endif
2342
Alex Martellia70b1912003-04-22 08:12:33 +00002343 for(;;) {
2344 item = PyIter_Next(iter);
2345 if (item == NULL) {
2346 /* error, or end-of-sequence */
2347 if (PyErr_Occurred()) {
2348 Py_DECREF(result);
2349 result = NULL;
2350 }
2351 break;
2352 }
Mark Dickinson0e0e2152009-10-26 14:18:44 +00002353 /* It's tempting to use PyNumber_InPlaceAdd instead of
2354 PyNumber_Add here, to avoid quadratic running time
2355 when doing 'sum(list_of_lists, [])'. However, this
2356 would produce a change in behaviour: a snippet like
2357
2358 empty = []
2359 sum([[x] for x in range(10)], empty)
2360
2361 would change the value of empty. */
Alex Martellia253e182003-10-25 23:24:14 +00002362 temp = PyNumber_Add(result, item);
Alex Martellia70b1912003-04-22 08:12:33 +00002363 Py_DECREF(result);
2364 Py_DECREF(item);
2365 result = temp;
2366 if (result == NULL)
2367 break;
2368 }
2369 Py_DECREF(iter);
2370 return result;
2371}
2372
2373PyDoc_STRVAR(sum_doc,
Georg Brandl8134d062006-10-12 12:33:07 +00002374"sum(sequence[, start]) -> value\n\
Alex Martellia70b1912003-04-22 08:12:33 +00002375\n\
2376Returns the sum of a sequence of numbers (NOT strings) plus the value\n\
Georg Brandl8134d062006-10-12 12:33:07 +00002377of parameter 'start' (which defaults to 0). When the sequence is\n\
2378empty, returns start.");
Alex Martellia70b1912003-04-22 08:12:33 +00002379
2380
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002381static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002382builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002383{
2384 PyObject *inst;
2385 PyObject *cls;
Guido van Rossum823649d2001-03-21 18:40:58 +00002386 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002387
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002388 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002389 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002390
Guido van Rossum823649d2001-03-21 18:40:58 +00002391 retval = PyObject_IsInstance(inst, cls);
2392 if (retval < 0)
Guido van Rossumad991772001-01-12 16:03:05 +00002393 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002394 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002395}
2396
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002397PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002398"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002399\n\
2400Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002401With a type as second argument, return whether that is the object's type.\n\
2402The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002403isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002404
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002405
2406static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002407builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002408{
2409 PyObject *derived;
2410 PyObject *cls;
2411 int retval;
2412
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002413 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002414 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002415
Guido van Rossum823649d2001-03-21 18:40:58 +00002416 retval = PyObject_IsSubclass(derived, cls);
2417 if (retval < 0)
2418 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002419 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002420}
2421
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002422PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002423"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002424\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002425Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2426When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2427is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002428
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002429
Barry Warsawbd599b52000-08-03 15:45:29 +00002430static PyObject*
2431builtin_zip(PyObject *self, PyObject *args)
2432{
2433 PyObject *ret;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002434 const Py_ssize_t itemsize = PySequence_Length(args);
2435 Py_ssize_t i;
Tim Peters8572b4f2001-05-06 01:05:02 +00002436 PyObject *itlist; /* tuple of iterators */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002437 Py_ssize_t len; /* guess at result length */
Barry Warsawbd599b52000-08-03 15:45:29 +00002438
Raymond Hettingereaef6152003-08-02 07:42:57 +00002439 if (itemsize == 0)
2440 return PyList_New(0);
2441
Barry Warsawbd599b52000-08-03 15:45:29 +00002442 /* args must be a tuple */
2443 assert(PyTuple_Check(args));
2444
Tim Peters39a86c22002-05-12 07:19:38 +00002445 /* Guess at result length: the shortest of the input lengths.
2446 If some argument refuses to say, we refuse to guess too, lest
2447 an argument like xrange(sys.maxint) lead us astray.*/
Tim Peters67d687a2002-04-29 21:27:32 +00002448 len = -1; /* unknown */
2449 for (i = 0; i < itemsize; ++i) {
2450 PyObject *item = PyTuple_GET_ITEM(args, i);
Benjamin Peterson4c1fe512009-05-09 19:17:59 +00002451 Py_ssize_t thislen = _PyObject_LengthHint(item, -2);
Tim Peters39a86c22002-05-12 07:19:38 +00002452 if (thislen < 0) {
Benjamin Peterson4c1fe512009-05-09 19:17:59 +00002453 if (thislen == -1)
2454 return NULL;
Tim Peters39a86c22002-05-12 07:19:38 +00002455 len = -1;
2456 break;
2457 }
Tim Peters67d687a2002-04-29 21:27:32 +00002458 else if (len < 0 || thislen < len)
2459 len = thislen;
2460 }
2461
Tim Peters8572b4f2001-05-06 01:05:02 +00002462 /* allocate result list */
Tim Peters67d687a2002-04-29 21:27:32 +00002463 if (len < 0)
2464 len = 10; /* arbitrary */
2465 if ((ret = PyList_New(len)) == NULL)
Barry Warsawbd599b52000-08-03 15:45:29 +00002466 return NULL;
2467
Tim Peters8572b4f2001-05-06 01:05:02 +00002468 /* obtain iterators */
2469 itlist = PyTuple_New(itemsize);
2470 if (itlist == NULL)
2471 goto Fail_ret;
2472 for (i = 0; i < itemsize; ++i) {
2473 PyObject *item = PyTuple_GET_ITEM(args, i);
2474 PyObject *it = PyObject_GetIter(item);
Benjamin Petersond692a712009-09-07 13:02:15 +00002475 if (it == NULL) {
2476 if (PyErr_ExceptionMatches(PyExc_TypeError))
2477 PyErr_Format(PyExc_TypeError,
2478 "zip argument #%zd must support iteration",
2479 i+1);
Tim Peters8572b4f2001-05-06 01:05:02 +00002480 goto Fail_ret_itlist;
Benjamin Petersond692a712009-09-07 13:02:15 +00002481 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002482 PyTuple_SET_ITEM(itlist, i, it);
2483 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002484
Tim Peters8572b4f2001-05-06 01:05:02 +00002485 /* build result into ret list */
Tim Peters67d687a2002-04-29 21:27:32 +00002486 for (i = 0; ; ++i) {
2487 int j;
Tim Peters8572b4f2001-05-06 01:05:02 +00002488 PyObject *next = PyTuple_New(itemsize);
2489 if (!next)
2490 goto Fail_ret_itlist;
2491
Tim Peters67d687a2002-04-29 21:27:32 +00002492 for (j = 0; j < itemsize; j++) {
2493 PyObject *it = PyTuple_GET_ITEM(itlist, j);
Tim Peters8572b4f2001-05-06 01:05:02 +00002494 PyObject *item = PyIter_Next(it);
Barry Warsawbd599b52000-08-03 15:45:29 +00002495 if (!item) {
Tim Peters8572b4f2001-05-06 01:05:02 +00002496 if (PyErr_Occurred()) {
2497 Py_DECREF(ret);
2498 ret = NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002499 }
2500 Py_DECREF(next);
Tim Peters8572b4f2001-05-06 01:05:02 +00002501 Py_DECREF(itlist);
Tim Peters67d687a2002-04-29 21:27:32 +00002502 goto Done;
Barry Warsawbd599b52000-08-03 15:45:29 +00002503 }
Tim Peters67d687a2002-04-29 21:27:32 +00002504 PyTuple_SET_ITEM(next, j, item);
Barry Warsawbd599b52000-08-03 15:45:29 +00002505 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002506
Tim Peters67d687a2002-04-29 21:27:32 +00002507 if (i < len)
2508 PyList_SET_ITEM(ret, i, next);
2509 else {
2510 int status = PyList_Append(ret, next);
2511 Py_DECREF(next);
2512 ++len;
2513 if (status < 0)
2514 goto Fail_ret_itlist;
2515 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002516 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002517
Tim Peters67d687a2002-04-29 21:27:32 +00002518Done:
2519 if (ret != NULL && i < len) {
2520 /* The list is too big. */
2521 if (PyList_SetSlice(ret, i, len, NULL) < 0)
2522 return NULL;
2523 }
2524 return ret;
2525
Tim Peters8572b4f2001-05-06 01:05:02 +00002526Fail_ret_itlist:
2527 Py_DECREF(itlist);
2528Fail_ret:
2529 Py_DECREF(ret);
2530 return NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002531}
2532
2533
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002534PyDoc_STRVAR(zip_doc,
Barry Warsawbd599b52000-08-03 15:45:29 +00002535"zip(seq1 [, seq2 [...]]) -> [(seq1[0], seq2[0] ...), (...)]\n\
2536\n\
2537Return a list of tuples, where each tuple contains the i-th element\n\
2538from each of the argument sequences. The returned list is truncated\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002539in length to the length of the shortest argument sequence.");
Barry Warsawbd599b52000-08-03 15:45:29 +00002540
2541
Guido van Rossum79f25d91997-04-29 20:08:16 +00002542static PyMethodDef builtin_methods[] = {
Neal Norwitz92e212f2006-04-03 04:48:37 +00002543 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002544 {"abs", builtin_abs, METH_O, abs_doc},
Raymond Hettinger96229b12005-03-11 06:49:40 +00002545 {"all", builtin_all, METH_O, all_doc},
2546 {"any", builtin_any, METH_O, any_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002547 {"apply", builtin_apply, METH_VARARGS, apply_doc},
Eric Smith3cd81942008-02-22 16:30:22 +00002548 {"bin", builtin_bin, METH_O, bin_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002549 {"callable", builtin_callable, METH_O, callable_doc},
2550 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2551 {"cmp", builtin_cmp, METH_VARARGS, cmp_doc},
2552 {"coerce", builtin_coerce, METH_VARARGS, coerce_doc},
Georg Brandl5240d742007-03-13 20:46:32 +00002553 {"compile", (PyCFunction)builtin_compile, METH_VARARGS | METH_KEYWORDS, compile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002554 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2555 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2556 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2557 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2558 {"execfile", builtin_execfile, METH_VARARGS, execfile_doc},
2559 {"filter", builtin_filter, METH_VARARGS, filter_doc},
Eric Smitha9f7d622008-02-17 19:46:49 +00002560 {"format", builtin_format, METH_VARARGS, format_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002561 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2562 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2563 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2564 {"hash", builtin_hash, METH_O, hash_doc},
2565 {"hex", builtin_hex, METH_O, hex_doc},
2566 {"id", builtin_id, METH_O, id_doc},
2567 {"input", builtin_input, METH_VARARGS, input_doc},
2568 {"intern", builtin_intern, METH_VARARGS, intern_doc},
2569 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2570 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2571 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2572 {"len", builtin_len, METH_O, len_doc},
2573 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2574 {"map", builtin_map, METH_VARARGS, map_doc},
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00002575 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2576 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
Georg Brandl28e08732008-04-30 19:47:09 +00002577 {"next", builtin_next, METH_VARARGS, next_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002578 {"oct", builtin_oct, METH_O, oct_doc},
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00002579 {"open", (PyCFunction)builtin_open, METH_VARARGS | METH_KEYWORDS, open_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002580 {"ord", builtin_ord, METH_O, ord_doc},
2581 {"pow", builtin_pow, METH_VARARGS, pow_doc},
Eric Smith7c478942008-03-18 23:45:49 +00002582 {"print", (PyCFunction)builtin_print, METH_VARARGS | METH_KEYWORDS, print_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002583 {"range", builtin_range, METH_VARARGS, range_doc},
2584 {"raw_input", builtin_raw_input, METH_VARARGS, raw_input_doc},
2585 {"reduce", builtin_reduce, METH_VARARGS, reduce_doc},
2586 {"reload", builtin_reload, METH_O, reload_doc},
2587 {"repr", builtin_repr, METH_O, repr_doc},
Georg Brandlccadf842006-03-31 18:54:53 +00002588 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002589 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
Raymond Hettinger64958a12003-12-17 20:43:33 +00002590 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
Alex Martellia70b1912003-04-22 08:12:33 +00002591 {"sum", builtin_sum, METH_VARARGS, sum_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002592#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002593 {"unichr", builtin_unichr, METH_VARARGS, unichr_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002594#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002595 {"vars", builtin_vars, METH_VARARGS, vars_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002596 {"zip", builtin_zip, METH_VARARGS, zip_doc},
Guido van Rossumc02e15c1991-12-16 13:03:00 +00002597 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002598};
2599
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002600PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002601"Built-in functions, exceptions, and other objects.\n\
2602\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002603Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002604
Guido van Rossum25ce5661997-08-02 03:10:38 +00002605PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002606_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002607{
Fred Drake5550de32000-06-20 04:54:19 +00002608 PyObject *mod, *dict, *debug;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002609 mod = Py_InitModule4("__builtin__", builtin_methods,
2610 builtin_doc, (PyObject *)NULL,
2611 PYTHON_API_VERSION);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002612 if (mod == NULL)
2613 return NULL;
2614 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002615
Tim Peters7571a0f2003-03-23 17:52:28 +00002616#ifdef Py_TRACE_REFS
2617 /* __builtin__ exposes a number of statically allocated objects
2618 * that, before this code was added in 2.3, never showed up in
2619 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2620 * result, programs leaking references to None and False (etc)
2621 * couldn't be diagnosed by examining sys.getobjects(0).
2622 */
2623#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2624#else
2625#define ADD_TO_ALL(OBJECT) (void)0
2626#endif
2627
Tim Peters4b7625e2001-09-13 21:37:17 +00002628#define SETBUILTIN(NAME, OBJECT) \
Tim Peters7571a0f2003-03-23 17:52:28 +00002629 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2630 return NULL; \
2631 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002632
2633 SETBUILTIN("None", Py_None);
2634 SETBUILTIN("Ellipsis", Py_Ellipsis);
2635 SETBUILTIN("NotImplemented", Py_NotImplemented);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002636 SETBUILTIN("False", Py_False);
2637 SETBUILTIN("True", Py_True);
Neal Norwitz32a7e7f2002-05-31 19:58:02 +00002638 SETBUILTIN("basestring", &PyBaseString_Type);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002639 SETBUILTIN("bool", &PyBool_Type);
Antoine Pitrou789be0c2009-04-02 21:18:34 +00002640 SETBUILTIN("memoryview", &PyMemoryView_Type);
Christian Heimes3497f942008-05-26 12:29:14 +00002641 SETBUILTIN("bytearray", &PyByteArray_Type);
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002642 SETBUILTIN("bytes", &PyString_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002643 SETBUILTIN("buffer", &PyBuffer_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002644 SETBUILTIN("classmethod", &PyClassMethod_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002645#ifndef WITHOUT_COMPLEX
Tim Peters4b7625e2001-09-13 21:37:17 +00002646 SETBUILTIN("complex", &PyComplex_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002647#endif
Tim Petersa427a2b2001-10-29 22:25:45 +00002648 SETBUILTIN("dict", &PyDict_Type);
Tim Peters67d687a2002-04-29 21:27:32 +00002649 SETBUILTIN("enumerate", &PyEnum_Type);
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00002650 SETBUILTIN("file", &PyFile_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002651 SETBUILTIN("float", &PyFloat_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002652 SETBUILTIN("frozenset", &PyFrozenSet_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002653 SETBUILTIN("property", &PyProperty_Type);
2654 SETBUILTIN("int", &PyInt_Type);
2655 SETBUILTIN("list", &PyList_Type);
2656 SETBUILTIN("long", &PyLong_Type);
2657 SETBUILTIN("object", &PyBaseObject_Type);
Raymond Hettinger85c20a42003-11-06 14:06:48 +00002658 SETBUILTIN("reversed", &PyReversed_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002659 SETBUILTIN("set", &PySet_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002660 SETBUILTIN("slice", &PySlice_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002661 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002662 SETBUILTIN("str", &PyString_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002663 SETBUILTIN("super", &PySuper_Type);
2664 SETBUILTIN("tuple", &PyTuple_Type);
2665 SETBUILTIN("type", &PyType_Type);
Raymond Hettingerc4c453f2002-06-05 23:12:45 +00002666 SETBUILTIN("xrange", &PyRange_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002667#ifdef Py_USING_UNICODE
Tim Peters4b7625e2001-09-13 21:37:17 +00002668 SETBUILTIN("unicode", &PyUnicode_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002669#endif
Guido van Rossum77f6a652002-04-03 22:41:51 +00002670 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
Fred Drake5550de32000-06-20 04:54:19 +00002671 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2672 Py_XDECREF(debug);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002673 return NULL;
Fred Drake5550de32000-06-20 04:54:19 +00002674 }
2675 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002676
Guido van Rossum25ce5661997-08-02 03:10:38 +00002677 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002678#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002679#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002680}
2681
Guido van Rossume77a7571993-11-03 15:01:26 +00002682/* Helper for filter(): filter a tuple through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002683
Guido van Rossum79f25d91997-04-29 20:08:16 +00002684static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002685filtertuple(PyObject *func, PyObject *tuple)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002686{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002687 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002688 Py_ssize_t i, j;
2689 Py_ssize_t len = PyTuple_Size(tuple);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002690
Guido van Rossumb7b45621995-08-04 04:07:45 +00002691 if (len == 0) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002692 if (PyTuple_CheckExact(tuple))
2693 Py_INCREF(tuple);
2694 else
2695 tuple = PyTuple_New(0);
Guido van Rossumb7b45621995-08-04 04:07:45 +00002696 return tuple;
2697 }
2698
Guido van Rossum79f25d91997-04-29 20:08:16 +00002699 if ((result = PyTuple_New(len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002700 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002701
Guido van Rossum12d12c51993-10-26 17:58:25 +00002702 for (i = j = 0; i < len; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002703 PyObject *item, *good;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002704 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002705
Walter Dörwald8dd19322003-02-10 17:36:40 +00002706 if (tuple->ob_type->tp_as_sequence &&
2707 tuple->ob_type->tp_as_sequence->sq_item) {
2708 item = tuple->ob_type->tp_as_sequence->sq_item(tuple, i);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002709 if (item == NULL)
2710 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002711 } else {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002712 PyErr_SetString(PyExc_TypeError, "filter(): unsubscriptable tuple");
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002713 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002714 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002715 if (func == Py_None) {
2716 Py_INCREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002717 good = item;
2718 }
2719 else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002720 PyObject *arg = PyTuple_Pack(1, item);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002721 if (arg == NULL) {
2722 Py_DECREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002723 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002724 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002725 good = PyEval_CallObject(func, arg);
2726 Py_DECREF(arg);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002727 if (good == NULL) {
2728 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002729 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002730 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002731 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002732 ok = PyObject_IsTrue(good);
2733 Py_DECREF(good);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002734 if (ok) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002735 if (PyTuple_SetItem(result, j++, item) < 0)
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002736 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002737 }
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002738 else
2739 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002740 }
2741
Tim Peters4324aa32001-05-28 22:30:08 +00002742 if (_PyTuple_Resize(&result, j) < 0)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002743 return NULL;
2744
Guido van Rossum12d12c51993-10-26 17:58:25 +00002745 return result;
2746
Guido van Rossum12d12c51993-10-26 17:58:25 +00002747Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002748 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002749 return NULL;
2750}
2751
2752
Guido van Rossume77a7571993-11-03 15:01:26 +00002753/* Helper for filter(): filter a string through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002754
Guido van Rossum79f25d91997-04-29 20:08:16 +00002755static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002756filterstring(PyObject *func, PyObject *strobj)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002757{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002758 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002759 Py_ssize_t i, j;
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002760 Py_ssize_t len = PyString_Size(strobj);
Martin v. Löwis18e16552006-02-15 17:27:45 +00002761 Py_ssize_t outlen = len;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002762
Guido van Rossum79f25d91997-04-29 20:08:16 +00002763 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002764 /* If it's a real string we can return the original,
2765 * as no character is ever false and __getitem__
2766 * does return this character. If it's a subclass
2767 * we must go through the __getitem__ loop */
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002768 if (PyString_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002769 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002770 return strobj;
2771 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002772 }
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002773 if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002774 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002775
Guido van Rossum12d12c51993-10-26 17:58:25 +00002776 for (i = j = 0; i < len; ++i) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002777 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002778 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002779
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002780 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2781 if (item == NULL)
2782 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002783 if (func==Py_None) {
2784 ok = 1;
2785 } else {
2786 PyObject *arg, *good;
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002787 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002788 if (arg == NULL) {
2789 Py_DECREF(item);
2790 goto Fail_1;
2791 }
2792 good = PyEval_CallObject(func, arg);
2793 Py_DECREF(arg);
2794 if (good == NULL) {
2795 Py_DECREF(item);
2796 goto Fail_1;
2797 }
2798 ok = PyObject_IsTrue(good);
2799 Py_DECREF(good);
Tim Peters388ed082001-04-07 20:34:48 +00002800 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002801 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002802 Py_ssize_t reslen;
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002803 if (!PyString_Check(item)) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002804 PyErr_SetString(PyExc_TypeError, "can't filter str to str:"
2805 " __getitem__ returned different type");
2806 Py_DECREF(item);
2807 goto Fail_1;
2808 }
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002809 reslen = PyString_GET_SIZE(item);
Walter Dörwald903f1e02003-02-04 16:28:00 +00002810 if (reslen == 1) {
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002811 PyString_AS_STRING(result)[j++] =
2812 PyString_AS_STRING(item)[0];
Walter Dörwald903f1e02003-02-04 16:28:00 +00002813 } else {
2814 /* do we need more space? */
Gregory P. Smith9d534572008-06-11 07:41:16 +00002815 Py_ssize_t need = j;
2816
2817 /* calculate space requirements while checking for overflow */
2818 if (need > PY_SSIZE_T_MAX - reslen) {
2819 Py_DECREF(item);
2820 goto Fail_1;
2821 }
2822
2823 need += reslen;
2824
2825 if (need > PY_SSIZE_T_MAX - len) {
2826 Py_DECREF(item);
2827 goto Fail_1;
2828 }
2829
2830 need += len;
2831
2832 if (need <= i) {
2833 Py_DECREF(item);
2834 goto Fail_1;
2835 }
2836
2837 need = need - i - 1;
2838
2839 assert(need >= 0);
2840 assert(outlen >= 0);
2841
Walter Dörwald903f1e02003-02-04 16:28:00 +00002842 if (need > outlen) {
2843 /* overallocate, to avoid reallocations */
Gregory P. Smith9d534572008-06-11 07:41:16 +00002844 if (outlen > PY_SSIZE_T_MAX / 2) {
2845 Py_DECREF(item);
2846 return NULL;
2847 }
2848
2849 if (need<2*outlen) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002850 need = 2*outlen;
Gregory P. Smith9d534572008-06-11 07:41:16 +00002851 }
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002852 if (_PyString_Resize(&result, need)) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002853 Py_DECREF(item);
2854 return NULL;
2855 }
2856 outlen = need;
2857 }
2858 memcpy(
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002859 PyString_AS_STRING(result) + j,
2860 PyString_AS_STRING(item),
Walter Dörwald903f1e02003-02-04 16:28:00 +00002861 reslen
2862 );
2863 j += reslen;
2864 }
2865 }
Tim Peters388ed082001-04-07 20:34:48 +00002866 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002867 }
2868
Walter Dörwald903f1e02003-02-04 16:28:00 +00002869 if (j < outlen)
Gregory P. Smithdd96db62008-06-09 04:58:54 +00002870 _PyString_Resize(&result, j);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002871
Guido van Rossum12d12c51993-10-26 17:58:25 +00002872 return result;
2873
Guido van Rossum12d12c51993-10-26 17:58:25 +00002874Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002875 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002876 return NULL;
2877}
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002878
2879#ifdef Py_USING_UNICODE
2880/* Helper for filter(): filter a Unicode object through a function */
2881
2882static PyObject *
2883filterunicode(PyObject *func, PyObject *strobj)
2884{
2885 PyObject *result;
Martin v. Löwis725507b2006-03-07 12:08:51 +00002886 register Py_ssize_t i, j;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002887 Py_ssize_t len = PyUnicode_GetSize(strobj);
2888 Py_ssize_t outlen = len;
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002889
2890 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002891 /* If it's a real string we can return the original,
2892 * as no character is ever false and __getitem__
2893 * does return this character. If it's a subclass
2894 * we must go through the __getitem__ loop */
2895 if (PyUnicode_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002896 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002897 return strobj;
2898 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002899 }
2900 if ((result = PyUnicode_FromUnicode(NULL, len)) == NULL)
2901 return NULL;
2902
2903 for (i = j = 0; i < len; ++i) {
2904 PyObject *item, *arg, *good;
2905 int ok;
2906
2907 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2908 if (item == NULL)
2909 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002910 if (func == Py_None) {
2911 ok = 1;
2912 } else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002913 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002914 if (arg == NULL) {
2915 Py_DECREF(item);
2916 goto Fail_1;
2917 }
2918 good = PyEval_CallObject(func, arg);
2919 Py_DECREF(arg);
2920 if (good == NULL) {
2921 Py_DECREF(item);
2922 goto Fail_1;
2923 }
2924 ok = PyObject_IsTrue(good);
2925 Py_DECREF(good);
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002926 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002927 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002928 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002929 if (!PyUnicode_Check(item)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002930 PyErr_SetString(PyExc_TypeError,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002931 "can't filter unicode to unicode:"
2932 " __getitem__ returned different type");
Walter Dörwald903f1e02003-02-04 16:28:00 +00002933 Py_DECREF(item);
2934 goto Fail_1;
2935 }
2936 reslen = PyUnicode_GET_SIZE(item);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002937 if (reslen == 1)
Walter Dörwald903f1e02003-02-04 16:28:00 +00002938 PyUnicode_AS_UNICODE(result)[j++] =
2939 PyUnicode_AS_UNICODE(item)[0];
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002940 else {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002941 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002942 Py_ssize_t need = j + reslen + len - i - 1;
Gregory P. Smith9d534572008-06-11 07:41:16 +00002943
2944 /* check that didnt overflow */
2945 if ((j > PY_SSIZE_T_MAX - reslen) ||
2946 ((j + reslen) > PY_SSIZE_T_MAX - len) ||
2947 ((j + reslen + len) < i) ||
2948 ((j + reslen + len - i) <= 0)) {
2949 Py_DECREF(item);
2950 return NULL;
2951 }
2952
2953 assert(need >= 0);
2954 assert(outlen >= 0);
2955
Walter Dörwald903f1e02003-02-04 16:28:00 +00002956 if (need > outlen) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002957 /* overallocate,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002958 to avoid reallocations */
Gregory P. Smith9d534572008-06-11 07:41:16 +00002959 if (need < 2 * outlen) {
2960 if (outlen > PY_SSIZE_T_MAX / 2) {
2961 Py_DECREF(item);
2962 return NULL;
2963 } else {
2964 need = 2 * outlen;
2965 }
2966 }
2967
Jeremy Hylton364f6be2003-09-16 03:17:16 +00002968 if (PyUnicode_Resize(
2969 &result, need) < 0) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002970 Py_DECREF(item);
Walter Dörwald531e0002003-02-04 16:57:49 +00002971 goto Fail_1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002972 }
2973 outlen = need;
2974 }
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002975 memcpy(PyUnicode_AS_UNICODE(result) + j,
2976 PyUnicode_AS_UNICODE(item),
2977 reslen*sizeof(Py_UNICODE));
Walter Dörwald903f1e02003-02-04 16:28:00 +00002978 j += reslen;
2979 }
2980 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002981 Py_DECREF(item);
2982 }
2983
Walter Dörwald903f1e02003-02-04 16:28:00 +00002984 if (j < outlen)
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002985 PyUnicode_Resize(&result, j);
2986
2987 return result;
2988
2989Fail_1:
2990 Py_DECREF(result);
2991 return NULL;
2992}
2993#endif