blob: 45f4081aa0104ad9825d551aa1ec358723e296b4 [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{
214 return PyNumber_ToBase(v, 2);
215}
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. */
250 if (PyString_Check(seq))
251 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);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000271
Tim Peters0e57abf2001-05-02 07:39:38 +0000272 /* Get a result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000273 if (PyList_Check(seq) && seq->ob_refcnt == 1) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000274 /* Eww - can modify the list in-place. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000275 Py_INCREF(seq);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000276 result = seq;
277 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000278 else {
Tim Peters0e57abf2001-05-02 07:39:38 +0000279 result = PyList_New(len);
280 if (result == NULL)
281 goto Fail_it;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000282 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000283
Tim Peters0e57abf2001-05-02 07:39:38 +0000284 /* Build the result list. */
Tim Petersf4848da2001-05-05 00:14:56 +0000285 j = 0;
286 for (;;) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000287 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000288 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000289
Tim Peters0e57abf2001-05-02 07:39:38 +0000290 item = PyIter_Next(it);
291 if (item == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +0000292 if (PyErr_Occurred())
293 goto Fail_result_it;
Tim Peters0e57abf2001-05-02 07:39:38 +0000294 break;
Guido van Rossum2d951851994-08-29 12:52:16 +0000295 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000296
Neil Schemenauer68973552003-08-14 20:37:34 +0000297 if (func == (PyObject *)&PyBool_Type || func == Py_None) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000298 ok = PyObject_IsTrue(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000299 }
300 else {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000301 PyObject *good;
302 PyTuple_SET_ITEM(arg, 0, item);
303 good = PyObject_Call(func, arg, NULL);
304 PyTuple_SET_ITEM(arg, 0, NULL);
Guido van Rossum58b68731995-01-10 17:40:55 +0000305 if (good == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000306 Py_DECREF(item);
Tim Peters0e57abf2001-05-02 07:39:38 +0000307 goto Fail_result_it;
Guido van Rossum58b68731995-01-10 17:40:55 +0000308 }
Guido van Rossumc7903a12002-08-16 07:04:56 +0000309 ok = PyObject_IsTrue(good);
310 Py_DECREF(good);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000311 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000312 if (ok) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000313 if (j < len)
314 PyList_SET_ITEM(result, j, item);
Guido van Rossum2d951851994-08-29 12:52:16 +0000315 else {
Barry Warsawfa77e091999-01-28 18:49:12 +0000316 int status = PyList_Append(result, item);
Barry Warsawfa77e091999-01-28 18:49:12 +0000317 Py_DECREF(item);
318 if (status < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000319 goto Fail_result_it;
Guido van Rossum2d951851994-08-29 12:52:16 +0000320 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000321 ++j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000322 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000323 else
324 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000325 }
326
Guido van Rossum12d12c51993-10-26 17:58:25 +0000327
Tim Peters0e57abf2001-05-02 07:39:38 +0000328 /* Cut back result list if len is too big. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000329 if (j < len && PyList_SetSlice(result, j, len, NULL) < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000330 goto Fail_result_it;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000331
Tim Peters3c6b1482001-05-21 08:07:05 +0000332 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000333 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000334 return result;
335
Tim Peters0e57abf2001-05-02 07:39:38 +0000336Fail_result_it:
Guido van Rossum79f25d91997-04-29 20:08:16 +0000337 Py_DECREF(result);
Tim Peters0e57abf2001-05-02 07:39:38 +0000338Fail_it:
339 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000340Fail_arg:
341 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000342 return NULL;
343}
344
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000345PyDoc_STRVAR(filter_doc,
Tim Petersd50e5442002-03-09 00:06:26 +0000346"filter(function or None, sequence) -> list, tuple, or string\n"
347"\n"
348"Return those items of sequence for which function(item) is true. If\n"
349"function is None, return the items that are true. If sequence is a tuple\n"
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000350"or string, return the same type, else return a list.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000351
Guido van Rossum79f25d91997-04-29 20:08:16 +0000352static PyObject *
Eric Smitha9f7d622008-02-17 19:46:49 +0000353builtin_format(PyObject *self, PyObject *args)
354{
355 PyObject *value;
356 PyObject *format_spec = NULL;
357
358 if (!PyArg_ParseTuple(args, "O|O:format", &value, &format_spec))
359 return NULL;
360
361 return PyObject_Format(value, format_spec);
362}
363
364PyDoc_STRVAR(format_doc,
365"format(value[, format_spec]) -> string\n\
366\n\
367Returns value.__format__(format_spec)\n\
368format_spec defaults to \"\"");
369
370static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000371builtin_chr(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000372{
373 long x;
374 char s[1];
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000375
Guido van Rossum79f25d91997-04-29 20:08:16 +0000376 if (!PyArg_ParseTuple(args, "l:chr", &x))
Guido van Rossum3f5da241990-12-20 15:06:42 +0000377 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000378 if (x < 0 || x >= 256) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000379 PyErr_SetString(PyExc_ValueError,
380 "chr() arg not in range(256)");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000381 return NULL;
382 }
Guido van Rossum6bf62da1997-04-11 20:37:35 +0000383 s[0] = (char)x;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000384 return PyString_FromStringAndSize(s, 1);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000385}
386
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000387PyDoc_STRVAR(chr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000388"chr(i) -> character\n\
389\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000390Return a string of one character with ordinal i; 0 <= i < 256.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000391
392
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000393#ifdef Py_USING_UNICODE
Guido van Rossum79f25d91997-04-29 20:08:16 +0000394static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000395builtin_unichr(PyObject *self, PyObject *args)
Guido van Rossum09095f32000-03-10 23:00:52 +0000396{
397 long x;
Guido van Rossum09095f32000-03-10 23:00:52 +0000398
399 if (!PyArg_ParseTuple(args, "l:unichr", &x))
400 return NULL;
Fredrik Lundh0dcf67e2001-06-26 20:01:56 +0000401
Marc-André Lemburgcc8764c2002-08-11 12:23:04 +0000402 return PyUnicode_FromOrdinal(x);
Guido van Rossum09095f32000-03-10 23:00:52 +0000403}
404
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000405PyDoc_STRVAR(unichr_doc,
Fred Drake078b24f2000-04-13 02:42:50 +0000406"unichr(i) -> Unicode character\n\
Guido van Rossum09095f32000-03-10 23:00:52 +0000407\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000408Return a Unicode string of one character with ordinal i; 0 <= i <= 0x10ffff.");
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000409#endif
Guido van Rossum09095f32000-03-10 23:00:52 +0000410
411
412static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000413builtin_cmp(PyObject *self, PyObject *args)
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000414{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000415 PyObject *a, *b;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000416 int c;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000417
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000418 if (!PyArg_UnpackTuple(args, "cmp", 2, 2, &a, &b))
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000419 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000420 if (PyObject_Cmp(a, b, &c) < 0)
Guido van Rossumc8b6df91997-05-23 00:06:51 +0000421 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000422 return PyInt_FromLong((long)c);
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000423}
424
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000425PyDoc_STRVAR(cmp_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000426"cmp(x, y) -> integer\n\
427\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000428Return negative if x<y, zero if x==y, positive if x>y.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000429
430
Guido van Rossum79f25d91997-04-29 20:08:16 +0000431static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000432builtin_coerce(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000433{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000434 PyObject *v, *w;
435 PyObject *res;
Guido van Rossum5524a591995-01-10 15:26:20 +0000436
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000437 if (PyErr_WarnPy3k("coerce() not supported in 3.x", 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +0000438 return NULL;
439
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000440 if (!PyArg_UnpackTuple(args, "coerce", 2, 2, &v, &w))
Guido van Rossum5524a591995-01-10 15:26:20 +0000441 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000442 if (PyNumber_Coerce(&v, &w) < 0)
Guido van Rossum04691fc1992-08-12 15:35:34 +0000443 return NULL;
Raymond Hettinger8ae46892003-10-12 19:09:37 +0000444 res = PyTuple_Pack(2, v, w);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000445 Py_DECREF(v);
446 Py_DECREF(w);
Guido van Rossum04691fc1992-08-12 15:35:34 +0000447 return res;
448}
449
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000450PyDoc_STRVAR(coerce_doc,
Martin v. Löwis8d494f32004-08-25 10:42:41 +0000451"coerce(x, y) -> (x1, y1)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000452\n\
Martin v. Löwis8d494f32004-08-25 10:42:41 +0000453Return a tuple consisting of the two numeric arguments converted to\n\
454a common type, using the same rules as used by arithmetic operations.\n\
455If coercion is not possible, raise TypeError.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000456
Guido van Rossum79f25d91997-04-29 20:08:16 +0000457static PyObject *
Georg Brandl5240d742007-03-13 20:46:32 +0000458builtin_compile(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum5b722181993-03-30 17:46:03 +0000459{
460 char *str;
461 char *filename;
462 char *startstr;
Georg Brandlf2bfd542008-03-29 13:24:23 +0000463 int mode = -1;
Tim Peters6cd6a822001-08-17 22:11:27 +0000464 int dont_inherit = 0;
465 int supplied_flags = 0;
Tim Peters5ba58662001-07-16 02:29:45 +0000466 PyCompilerFlags cf;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000467 PyObject *result = NULL, *cmd, *tmp = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000468 Py_ssize_t length;
Georg Brandl5240d742007-03-13 20:46:32 +0000469 static char *kwlist[] = {"source", "filename", "mode", "flags",
470 "dont_inherit", NULL};
Georg Brandlf2bfd542008-03-29 13:24:23 +0000471 int start[] = {Py_file_input, Py_eval_input, Py_single_input};
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000472
Georg Brandl5240d742007-03-13 20:46:32 +0000473 if (!PyArg_ParseTupleAndKeywords(args, kwds, "Oss|ii:compile",
474 kwlist, &cmd, &filename, &startstr,
475 &supplied_flags, &dont_inherit))
Guido van Rossum5b722181993-03-30 17:46:03 +0000476 return NULL;
Tim Peters6cd6a822001-08-17 22:11:27 +0000477
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000478 cf.cf_flags = supplied_flags;
479
Georg Brandlfc8eef32008-03-28 12:11:56 +0000480 if (supplied_flags &
481 ~(PyCF_MASK | PyCF_MASK_OBSOLETE | PyCF_DONT_IMPLY_DEDENT | PyCF_ONLY_AST))
482 {
483 PyErr_SetString(PyExc_ValueError,
484 "compile(): unrecognised flags");
485 return NULL;
486 }
487 /* XXX Warn if (supplied_flags & PyCF_MASK_OBSOLETE) != 0? */
488
489 if (!dont_inherit) {
490 PyEval_MergeCompilerFlags(&cf);
491 }
492
Georg Brandlf2bfd542008-03-29 13:24:23 +0000493 if (strcmp(startstr, "exec") == 0)
494 mode = 0;
495 else if (strcmp(startstr, "eval") == 0)
496 mode = 1;
497 else if (strcmp(startstr, "single") == 0)
498 mode = 2;
499 else {
500 PyErr_SetString(PyExc_ValueError,
501 "compile() arg 3 must be 'exec', 'eval' or 'single'");
502 return NULL;
503 }
504
Georg Brandlfc8eef32008-03-28 12:11:56 +0000505 if (PyAST_Check(cmd)) {
506 if (supplied_flags & PyCF_ONLY_AST) {
507 Py_INCREF(cmd);
508 result = cmd;
509 }
510 else {
511 PyArena *arena;
512 mod_ty mod;
513
514 arena = PyArena_New();
Georg Brandlf2bfd542008-03-29 13:24:23 +0000515 mod = PyAST_obj2mod(cmd, arena, mode);
Georg Brandlfc8eef32008-03-28 12:11:56 +0000516 if (mod == NULL) {
517 PyArena_Free(arena);
518 return NULL;
519 }
520 result = (PyObject*)PyAST_Compile(mod, filename,
521 &cf, arena);
522 PyArena_Free(arena);
523 }
524 return result;
525 }
526
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000527#ifdef Py_USING_UNICODE
528 if (PyUnicode_Check(cmd)) {
529 tmp = PyUnicode_AsUTF8String(cmd);
530 if (tmp == NULL)
531 return NULL;
532 cmd = tmp;
533 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
534 }
535#endif
Tim Peters6cd6a822001-08-17 22:11:27 +0000536
Georg Brandlfc8eef32008-03-28 12:11:56 +0000537 if (PyObject_AsReadBuffer(cmd, (const void **)&str, &length))
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000538 goto cleanup;
Georg Brandlfc8eef32008-03-28 12:11:56 +0000539 if ((size_t)length != strlen(str)) {
540 PyErr_SetString(PyExc_TypeError,
541 "compile() expected string without null bytes");
542 goto cleanup;
Tim Peters6cd6a822001-08-17 22:11:27 +0000543 }
Georg Brandlf2bfd542008-03-29 13:24:23 +0000544 result = Py_CompileStringFlags(str, filename, start[mode], &cf);
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000545cleanup:
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000546 Py_XDECREF(tmp);
547 return result;
Guido van Rossum5b722181993-03-30 17:46:03 +0000548}
549
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000550PyDoc_STRVAR(compile_doc,
Tim Peters6cd6a822001-08-17 22:11:27 +0000551"compile(source, filename, mode[, flags[, dont_inherit]]) -> code object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000552\n\
553Compile the source string (a Python module, statement or expression)\n\
554into a code object that can be executed by the exec statement or eval().\n\
555The filename will be used for run-time error messages.\n\
556The mode must be 'exec' to compile a module, 'single' to compile a\n\
Tim Peters6cd6a822001-08-17 22:11:27 +0000557single (interactive) statement, or 'eval' to compile an expression.\n\
558The flags argument, if present, controls which future statements influence\n\
559the compilation of the code.\n\
560The dont_inherit argument, if non-zero, stops the compilation inheriting\n\
561the effects of any future statements in effect in the code calling\n\
562compile; if absent or zero these statements do influence the compilation,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000563in addition to any features explicitly specified.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000564
Guido van Rossum79f25d91997-04-29 20:08:16 +0000565static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000566builtin_dir(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000567{
Tim Peters5d2b77c2001-09-03 05:47:38 +0000568 PyObject *arg = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000569
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000570 if (!PyArg_UnpackTuple(args, "dir", 0, 1, &arg))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000571 return NULL;
Tim Peters7eea37e2001-09-04 22:08:56 +0000572 return PyObject_Dir(arg);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000573}
574
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000575PyDoc_STRVAR(dir_doc,
Tim Peters5d2b77c2001-09-03 05:47:38 +0000576"dir([object]) -> list of strings\n"
577"\n"
Georg Brandl871f1bc2007-03-12 13:17:36 +0000578"If called without an argument, return the names in the current scope.\n"
579"Else, return an alphabetized list of names comprising (some of) the attributes\n"
580"of the given object, and of attributes reachable from it.\n"
581"If the object supplies a method named __dir__, it will be used; otherwise\n"
582"the default dir() logic is used and returns:\n"
583" for a module object: the module's attributes.\n"
584" for a class object: its attributes, and recursively the attributes\n"
585" of its bases.\n"
Georg Brandl3bb15672007-03-13 07:23:16 +0000586" for any other object: its attributes, its class's attributes, and\n"
Georg Brandl871f1bc2007-03-12 13:17:36 +0000587" recursively the attributes of its class's base classes.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000588
Guido van Rossum79f25d91997-04-29 20:08:16 +0000589static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000590builtin_divmod(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000591{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000592 PyObject *v, *w;
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000593
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000594 if (!PyArg_UnpackTuple(args, "divmod", 2, 2, &v, &w))
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000595 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000596 return PyNumber_Divmod(v, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000597}
598
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000599PyDoc_STRVAR(divmod_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000600"divmod(x, y) -> (div, mod)\n\
601\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000602Return the tuple ((x-x%y)/y, x%y). Invariant: div*y + mod == x.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000603
604
Guido van Rossum79f25d91997-04-29 20:08:16 +0000605static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000606builtin_eval(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000607{
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000608 PyObject *cmd, *result, *tmp = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000609 PyObject *globals = Py_None, *locals = Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000610 char *str;
Tim Peters9fa96be2001-08-17 23:04:59 +0000611 PyCompilerFlags cf;
Guido van Rossum590baa41993-11-30 13:40:46 +0000612
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000613 if (!PyArg_UnpackTuple(args, "eval", 1, 3, &cmd, &globals, &locals))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000614 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000615 if (locals != Py_None && !PyMapping_Check(locals)) {
616 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000617 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000618 }
619 if (globals != Py_None && !PyDict_Check(globals)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +0000620 PyErr_SetString(PyExc_TypeError, PyMapping_Check(globals) ?
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000621 "globals must be a real dict; try eval(expr, {}, mapping)"
622 : "globals must be a dict");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000623 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000624 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000625 if (globals == Py_None) {
626 globals = PyEval_GetGlobals();
627 if (locals == Py_None)
628 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000629 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000630 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000631 locals = globals;
Tim Peters9fa96be2001-08-17 23:04:59 +0000632
Georg Brandl77c85e62005-09-15 10:46:13 +0000633 if (globals == NULL || locals == NULL) {
634 PyErr_SetString(PyExc_TypeError,
635 "eval must be given globals and locals "
636 "when called without a frame");
637 return NULL;
638 }
639
Guido van Rossum79f25d91997-04-29 20:08:16 +0000640 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
641 if (PyDict_SetItemString(globals, "__builtins__",
642 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000643 return NULL;
644 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000645
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000646 if (PyCode_Check(cmd)) {
Jeremy Hylton733c8932001-12-13 19:51:56 +0000647 if (PyCode_GetNumFree((PyCodeObject *)cmd) > 0) {
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000648 PyErr_SetString(PyExc_TypeError,
649 "code object passed to eval() may not contain free variables");
650 return NULL;
651 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000652 return PyEval_EvalCode((PyCodeObject *) cmd, globals, locals);
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000653 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000654
Marc-André Lemburgd1ba4432000-09-19 21:04:18 +0000655 if (!PyString_Check(cmd) &&
656 !PyUnicode_Check(cmd)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000657 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +0000658 "eval() arg 1 must be a string or code object");
Guido van Rossum94390a41992-08-14 15:14:30 +0000659 return NULL;
660 }
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000661 cf.cf_flags = 0;
662
663#ifdef Py_USING_UNICODE
664 if (PyUnicode_Check(cmd)) {
665 tmp = PyUnicode_AsUTF8String(cmd);
666 if (tmp == NULL)
667 return NULL;
668 cmd = tmp;
669 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
670 }
671#endif
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000672 if (PyString_AsStringAndSize(cmd, &str, NULL)) {
673 Py_XDECREF(tmp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000674 return NULL;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000675 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000676 while (*str == ' ' || *str == '\t')
677 str++;
Tim Peters9fa96be2001-08-17 23:04:59 +0000678
Tim Peters9fa96be2001-08-17 23:04:59 +0000679 (void)PyEval_MergeCompilerFlags(&cf);
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000680 result = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
681 Py_XDECREF(tmp);
682 return result;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000683}
684
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000685PyDoc_STRVAR(eval_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000686"eval(source[, globals[, locals]]) -> value\n\
687\n\
688Evaluate the source in the context of globals and locals.\n\
689The source may be a string representing a Python expression\n\
690or a code object as returned by compile().\n\
Neal Norwitz477ca1c2006-09-05 02:25:41 +0000691The globals must be a dictionary and locals can be any mapping,\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000692defaulting to the current globals and locals.\n\
693If only globals is given, locals defaults to it.\n");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000694
695
Guido van Rossum79f25d91997-04-29 20:08:16 +0000696static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000697builtin_execfile(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000698{
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000699 char *filename;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000700 PyObject *globals = Py_None, *locals = Py_None;
701 PyObject *res;
Guido van Rossumb3a639e2001-09-05 13:37:47 +0000702 FILE* fp = NULL;
Tim Peters5ba58662001-07-16 02:29:45 +0000703 PyCompilerFlags cf;
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000704 int exists;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000705
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000706 if (PyErr_WarnPy3k("execfile() not supported in 3.x; use exec()",
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000707 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +0000708 return NULL;
709
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000710 if (!PyArg_ParseTuple(args, "s|O!O:execfile",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000711 &filename,
Guido van Rossum79f25d91997-04-29 20:08:16 +0000712 &PyDict_Type, &globals,
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000713 &locals))
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000714 return NULL;
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000715 if (locals != Py_None && !PyMapping_Check(locals)) {
716 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
717 return NULL;
718 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000719 if (globals == Py_None) {
720 globals = PyEval_GetGlobals();
721 if (locals == Py_None)
722 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000723 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000724 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000725 locals = globals;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000726 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
727 if (PyDict_SetItemString(globals, "__builtins__",
728 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000729 return NULL;
730 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000731
732 exists = 0;
733 /* Test for existence or directory. */
Martin v. Löwis3484a182002-03-09 12:07:51 +0000734#if defined(PLAN9)
735 {
736 Dir *d;
737
738 if ((d = dirstat(filename))!=nil) {
739 if(d->mode & DMDIR)
740 werrstr("is a directory");
741 else
742 exists = 1;
743 free(d);
744 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000745 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000746#elif defined(RISCOS)
Guido van Rossume2ae77b2001-10-24 20:42:55 +0000747 if (object_exists(filename)) {
748 if (isdir(filename))
749 errno = EISDIR;
750 else
751 exists = 1;
752 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000753#else /* standard Posix */
754 {
755 struct stat s;
756 if (stat(filename, &s) == 0) {
757 if (S_ISDIR(s.st_mode))
Andrew MacIntyreda4d6cb2004-03-29 11:53:38 +0000758# if defined(PYOS_OS2) && defined(PYCC_VACPP)
Martin v. Löwis3484a182002-03-09 12:07:51 +0000759 errno = EOS2ERR;
760# else
761 errno = EISDIR;
762# endif
763 else
764 exists = 1;
765 }
766 }
767#endif
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000768
769 if (exists) {
770 Py_BEGIN_ALLOW_THREADS
Jack Jansen7b8c7542002-04-14 20:12:41 +0000771 fp = fopen(filename, "r" PY_STDIOTEXTMODE);
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000772 Py_END_ALLOW_THREADS
773
774 if (fp == NULL) {
775 exists = 0;
776 }
777 }
778
779 if (!exists) {
Peter Schneider-Kamp4c013422002-08-27 16:58:00 +0000780 PyErr_SetFromErrnoWithFilename(PyExc_IOError, filename);
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000781 return NULL;
782 }
Tim Peters5ba58662001-07-16 02:29:45 +0000783 cf.cf_flags = 0;
784 if (PyEval_MergeCompilerFlags(&cf))
Tim Peters748b8bb2001-04-28 08:20:22 +0000785 res = PyRun_FileExFlags(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000786 locals, 1, &cf);
Tim Peters5ba58662001-07-16 02:29:45 +0000787 else
Tim Peters748b8bb2001-04-28 08:20:22 +0000788 res = PyRun_FileEx(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000789 locals, 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000790 return res;
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000791}
792
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000793PyDoc_STRVAR(execfile_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000794"execfile(filename[, globals[, locals]])\n\
795\n\
796Read and execute a Python script from a file.\n\
797The globals and locals are dictionaries, defaulting to the current\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000798globals and locals. If only globals is given, locals defaults to it.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000799
800
Guido van Rossum79f25d91997-04-29 20:08:16 +0000801static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000802builtin_getattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000803{
Guido van Rossum950ff291998-06-29 13:38:57 +0000804 PyObject *v, *result, *dflt = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000805 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000806
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000807 if (!PyArg_UnpackTuple(args, "getattr", 2, 3, &v, &name, &dflt))
Guido van Rossum33894be1992-01-27 16:53:09 +0000808 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000809#ifdef Py_USING_UNICODE
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000810 if (PyUnicode_Check(name)) {
811 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
812 if (name == NULL)
813 return NULL;
814 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000815#endif
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000816
817 if (!PyString_Check(name)) {
818 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000819 "getattr(): attribute name must be string");
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000820 return NULL;
821 }
Guido van Rossum950ff291998-06-29 13:38:57 +0000822 result = PyObject_GetAttr(v, name);
Guido van Rossumd8923572001-10-16 21:31:32 +0000823 if (result == NULL && dflt != NULL &&
824 PyErr_ExceptionMatches(PyExc_AttributeError))
825 {
Guido van Rossum950ff291998-06-29 13:38:57 +0000826 PyErr_Clear();
827 Py_INCREF(dflt);
828 result = dflt;
829 }
830 return result;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000831}
832
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000833PyDoc_STRVAR(getattr_doc,
Guido van Rossum950ff291998-06-29 13:38:57 +0000834"getattr(object, name[, default]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000835\n\
Guido van Rossum950ff291998-06-29 13:38:57 +0000836Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
837When a default argument is given, it is returned when the attribute doesn't\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000838exist; without it, an exception is raised in that case.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000839
840
Guido van Rossum79f25d91997-04-29 20:08:16 +0000841static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000842builtin_globals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +0000843{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000844 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000845
Guido van Rossum79f25d91997-04-29 20:08:16 +0000846 d = PyEval_GetGlobals();
Neal Norwitz43bd4db2006-08-12 01:46:42 +0000847 Py_XINCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +0000848 return d;
849}
850
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000851PyDoc_STRVAR(globals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000852"globals() -> dictionary\n\
853\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000854Return the dictionary containing the current scope's global variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000855
856
Guido van Rossum79f25d91997-04-29 20:08:16 +0000857static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000858builtin_hasattr(PyObject *self, PyObject *args)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000859{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000860 PyObject *v;
861 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000862
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000863 if (!PyArg_UnpackTuple(args, "hasattr", 2, 2, &v, &name))
Guido van Rossum9bfef441993-03-29 10:43:31 +0000864 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000865#ifdef Py_USING_UNICODE
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000866 if (PyUnicode_Check(name)) {
867 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
868 if (name == NULL)
869 return NULL;
870 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000871#endif
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000872
873 if (!PyString_Check(name)) {
874 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000875 "hasattr(): attribute name must be string");
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000876 return NULL;
877 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000878 v = PyObject_GetAttr(v, name);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000879 if (v == NULL) {
Benjamin Petersonb9030f42008-05-12 00:41:23 +0000880 if (!PyErr_ExceptionMatches(PyExc_Exception))
881 return NULL;
882 else {
883 PyErr_Clear();
884 Py_INCREF(Py_False);
885 return Py_False;
886 }
Guido van Rossum9bfef441993-03-29 10:43:31 +0000887 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000888 Py_DECREF(v);
Guido van Rossum09df08a1998-05-22 00:51:39 +0000889 Py_INCREF(Py_True);
890 return Py_True;
Guido van Rossum33894be1992-01-27 16:53:09 +0000891}
892
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000893PyDoc_STRVAR(hasattr_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000894"hasattr(object, name) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000895\n\
896Return whether the object has an attribute with the given name.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000897(This is done by calling getattr(object, name) and catching exceptions.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000898
899
Guido van Rossum79f25d91997-04-29 20:08:16 +0000900static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000901builtin_id(PyObject *self, PyObject *v)
Guido van Rossum5b722181993-03-30 17:46:03 +0000902{
Guido van Rossum106f2da2000-06-28 21:12:25 +0000903 return PyLong_FromVoidPtr(v);
Guido van Rossum5b722181993-03-30 17:46:03 +0000904}
905
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000906PyDoc_STRVAR(id_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000907"id(object) -> integer\n\
908\n\
909Return the identity of an object. This is guaranteed to be unique among\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000910simultaneously existing objects. (Hint: it's the object's memory address.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000911
912
Guido van Rossum79f25d91997-04-29 20:08:16 +0000913static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000914builtin_map(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000915{
916 typedef struct {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000917 PyObject *it; /* the iterator object */
918 int saw_StopIteration; /* bool: did the iterator end? */
Guido van Rossum12d12c51993-10-26 17:58:25 +0000919 } sequence;
920
Guido van Rossum79f25d91997-04-29 20:08:16 +0000921 PyObject *func, *result;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000922 sequence *seqs = NULL, *sqp;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000923 Py_ssize_t n, len;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000924 register int i, j;
925
Guido van Rossum79f25d91997-04-29 20:08:16 +0000926 n = PyTuple_Size(args);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000927 if (n < 2) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000928 PyErr_SetString(PyExc_TypeError,
929 "map() requires at least two args");
Guido van Rossum12d12c51993-10-26 17:58:25 +0000930 return NULL;
931 }
932
Guido van Rossum79f25d91997-04-29 20:08:16 +0000933 func = PyTuple_GetItem(args, 0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000934 n--;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000935
Neal Norwitz53152a12008-02-24 02:20:25 +0000936 if (func == Py_None) {
Benjamin Peterson9f4f4812008-04-27 03:01:45 +0000937 if (PyErr_WarnPy3k("map(None, ...) not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +0000938 "use list(...)", 1) < 0)
Neal Norwitz53152a12008-02-24 02:20:25 +0000939 return NULL;
940 if (n == 1) {
941 /* map(None, S) is the same as list(S). */
942 return PySequence_List(PyTuple_GetItem(args, 1));
943 }
Guido van Rossumfa4ac711998-07-10 17:37:30 +0000944 }
945
Tim Peters4e9afdc2001-05-03 23:54:49 +0000946 /* Get space for sequence descriptors. Must NULL out the iterator
947 * pointers so that jumping to Fail_2 later doesn't see trash.
948 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000949 if ((seqs = PyMem_NEW(sequence, n)) == NULL) {
950 PyErr_NoMemory();
Tim Peters4e9afdc2001-05-03 23:54:49 +0000951 return NULL;
952 }
953 for (i = 0; i < n; ++i) {
954 seqs[i].it = (PyObject*)NULL;
955 seqs[i].saw_StopIteration = 0;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000956 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000957
Tim Peters4e9afdc2001-05-03 23:54:49 +0000958 /* Do a first pass to obtain iterators for the arguments, and set len
959 * to the largest of their lengths.
Tim Peters748b8bb2001-04-28 08:20:22 +0000960 */
Tim Peters4e9afdc2001-05-03 23:54:49 +0000961 len = 0;
962 for (i = 0, sqp = seqs; i < n; ++i, ++sqp) {
963 PyObject *curseq;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000964 Py_ssize_t curlen;
Guido van Rossumad991772001-01-12 16:03:05 +0000965
Tim Peters4e9afdc2001-05-03 23:54:49 +0000966 /* Get iterator. */
967 curseq = PyTuple_GetItem(args, i+1);
968 sqp->it = PyObject_GetIter(curseq);
969 if (sqp->it == NULL) {
Guido van Rossum12d12c51993-10-26 17:58:25 +0000970 static char errmsg[] =
Tim Peters4e9afdc2001-05-03 23:54:49 +0000971 "argument %d to map() must support iteration";
Guido van Rossum15e33a41997-04-30 19:00:27 +0000972 char errbuf[sizeof(errmsg) + 25];
Jeremy Hylton518ab1c2001-11-28 20:42:20 +0000973 PyOS_snprintf(errbuf, sizeof(errbuf), errmsg, i+2);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000974 PyErr_SetString(PyExc_TypeError, errbuf);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000975 goto Fail_2;
976 }
977
Tim Peters4e9afdc2001-05-03 23:54:49 +0000978 /* Update len. */
Raymond Hettinger4e2f7142007-12-06 00:56:53 +0000979 curlen = _PyObject_LengthHint(curseq, 8);
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000980 if (curlen > len)
981 len = curlen;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000982 }
983
Tim Peters4e9afdc2001-05-03 23:54:49 +0000984 /* Get space for the result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000985 if ((result = (PyObject *) PyList_New(len)) == NULL)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000986 goto Fail_2;
987
Tim Peters4e9afdc2001-05-03 23:54:49 +0000988 /* Iterate over the sequences until all have stopped. */
Guido van Rossum2d951851994-08-29 12:52:16 +0000989 for (i = 0; ; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000990 PyObject *alist, *item=NULL, *value;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000991 int numactive = 0;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000992
Guido van Rossum79f25d91997-04-29 20:08:16 +0000993 if (func == Py_None && n == 1)
Guido van Rossum32120311995-07-10 13:52:21 +0000994 alist = NULL;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000995 else if ((alist = PyTuple_New(n)) == NULL)
996 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000997
998 for (j = 0, sqp = seqs; j < n; ++j, ++sqp) {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000999 if (sqp->saw_StopIteration) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001000 Py_INCREF(Py_None);
1001 item = Py_None;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001002 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001003 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +00001004 item = PyIter_Next(sqp->it);
1005 if (item)
1006 ++numactive;
1007 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +00001008 if (PyErr_Occurred()) {
Tim Petersf4848da2001-05-05 00:14:56 +00001009 Py_XDECREF(alist);
1010 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001011 }
Tim Peters4e9afdc2001-05-03 23:54:49 +00001012 Py_INCREF(Py_None);
1013 item = Py_None;
1014 sqp->saw_StopIteration = 1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001015 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00001016 }
Tim Peters4e9afdc2001-05-03 23:54:49 +00001017 if (alist)
1018 PyTuple_SET_ITEM(alist, j, item);
1019 else
Guido van Rossum2d951851994-08-29 12:52:16 +00001020 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001021 }
1022
Guido van Rossum32120311995-07-10 13:52:21 +00001023 if (!alist)
1024 alist = item;
Guido van Rossum2d951851994-08-29 12:52:16 +00001025
Tim Peters4e9afdc2001-05-03 23:54:49 +00001026 if (numactive == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001027 Py_DECREF(alist);
Guido van Rossum2d951851994-08-29 12:52:16 +00001028 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001029 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001030
Guido van Rossum79f25d91997-04-29 20:08:16 +00001031 if (func == Py_None)
Guido van Rossum32120311995-07-10 13:52:21 +00001032 value = alist;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001033 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001034 value = PyEval_CallObject(func, alist);
1035 Py_DECREF(alist);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00001036 if (value == NULL)
1037 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001038 }
1039 if (i >= len) {
Barry Warsawfa77e091999-01-28 18:49:12 +00001040 int status = PyList_Append(result, value);
Barry Warsaw21332871999-01-28 04:21:35 +00001041 Py_DECREF(value);
Barry Warsawfa77e091999-01-28 18:49:12 +00001042 if (status < 0)
1043 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +00001044 }
Tim Peters4e9afdc2001-05-03 23:54:49 +00001045 else if (PyList_SetItem(result, i, value) < 0)
1046 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001047 }
1048
Guido van Rossumfa4ac711998-07-10 17:37:30 +00001049 if (i < len && PyList_SetSlice(result, i, len, NULL) < 0)
1050 goto Fail_1;
1051
Tim Peters4e9afdc2001-05-03 23:54:49 +00001052 goto Succeed;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001053
Guido van Rossum12d12c51993-10-26 17:58:25 +00001054Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001055 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001056Fail_2:
Tim Peters4e9afdc2001-05-03 23:54:49 +00001057 result = NULL;
1058Succeed:
1059 assert(seqs);
1060 for (i = 0; i < n; ++i)
1061 Py_XDECREF(seqs[i].it);
1062 PyMem_DEL(seqs);
1063 return result;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001064}
1065
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001066PyDoc_STRVAR(map_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001067"map(function, sequence[, sequence, ...]) -> list\n\
1068\n\
1069Return a list of the results of applying the function to the items of\n\
1070the argument sequence(s). If more than one sequence is given, the\n\
1071function is called with an argument list consisting of the corresponding\n\
1072item of each sequence, substituting None for missing values when not all\n\
1073sequences have the same length. If the function is None, return a list of\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001074the items of the sequence (or a list of tuples if more than one sequence).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001075
1076
Guido van Rossum79f25d91997-04-29 20:08:16 +00001077static PyObject *
Georg Brandl28e08732008-04-30 19:47:09 +00001078builtin_next(PyObject *self, PyObject *args)
1079{
1080 PyObject *it, *res;
1081 PyObject *def = NULL;
1082
1083 if (!PyArg_UnpackTuple(args, "next", 1, 2, &it, &def))
1084 return NULL;
1085 if (!PyIter_Check(it)) {
1086 PyErr_Format(PyExc_TypeError,
1087 "%.200s object is not an iterator",
1088 it->ob_type->tp_name);
1089 return NULL;
1090 }
1091
1092 res = (*it->ob_type->tp_iternext)(it);
1093 if (res != NULL) {
1094 return res;
1095 } else if (def != NULL) {
1096 if (PyErr_Occurred()) {
1097 if (!PyErr_ExceptionMatches(PyExc_StopIteration))
1098 return NULL;
1099 PyErr_Clear();
1100 }
1101 Py_INCREF(def);
1102 return def;
1103 } else if (PyErr_Occurred()) {
1104 return NULL;
1105 } else {
1106 PyErr_SetNone(PyExc_StopIteration);
1107 return NULL;
1108 }
1109}
1110
1111PyDoc_STRVAR(next_doc,
1112"next(iterator[, default])\n\
1113\n\
1114Return the next item from the iterator. If default is given and the iterator\n\
1115is exhausted, it is returned instead of raising StopIteration.");
1116
1117
1118static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001119builtin_setattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +00001120{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001121 PyObject *v;
1122 PyObject *name;
1123 PyObject *value;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001124
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001125 if (!PyArg_UnpackTuple(args, "setattr", 3, 3, &v, &name, &value))
Guido van Rossum33894be1992-01-27 16:53:09 +00001126 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001127 if (PyObject_SetAttr(v, name, value) != 0)
Guido van Rossum33894be1992-01-27 16:53:09 +00001128 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001129 Py_INCREF(Py_None);
1130 return Py_None;
Guido van Rossum33894be1992-01-27 16:53:09 +00001131}
1132
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001133PyDoc_STRVAR(setattr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001134"setattr(object, name, value)\n\
1135\n\
1136Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001137``x.y = v''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001138
1139
Guido van Rossum79f25d91997-04-29 20:08:16 +00001140static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001141builtin_delattr(PyObject *self, PyObject *args)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001142{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001143 PyObject *v;
1144 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001145
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001146 if (!PyArg_UnpackTuple(args, "delattr", 2, 2, &v, &name))
Guido van Rossum14144fc1994-08-29 12:53:40 +00001147 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001148 if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001149 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001150 Py_INCREF(Py_None);
1151 return Py_None;
Guido van Rossum14144fc1994-08-29 12:53:40 +00001152}
1153
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001154PyDoc_STRVAR(delattr_doc,
Guido van Rossumdf12a591998-11-23 22:13:04 +00001155"delattr(object, name)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001156\n\
1157Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001158``del x.y''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001159
1160
Guido van Rossum79f25d91997-04-29 20:08:16 +00001161static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001162builtin_hash(PyObject *self, PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00001163{
Guido van Rossum9bfef441993-03-29 10:43:31 +00001164 long x;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001165
Guido van Rossum79f25d91997-04-29 20:08:16 +00001166 x = PyObject_Hash(v);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001167 if (x == -1)
1168 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001169 return PyInt_FromLong(x);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001170}
1171
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001172PyDoc_STRVAR(hash_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001173"hash(object) -> integer\n\
1174\n\
1175Return a hash value for the object. Two objects with the same value have\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001176the same hash value. The reverse is not necessarily true, but likely.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001177
1178
Guido van Rossum79f25d91997-04-29 20:08:16 +00001179static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001180builtin_hex(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001181{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001182 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001183 PyObject *res;
Benjamin Peterson79a922d2008-05-17 19:21:20 +00001184
1185 nb = Py_TYPE(v)->tp_as_number;
1186
1187 if (nb != NULL && nb->nb_hex != NULL) {
1188 if (PyErr_WarnPy3k("In 3.x, hex() converts "
Benjamin Petersond7943cb2008-05-17 19:51:10 +00001189 "the result of __index__ to hexadecimal.",
Benjamin Peterson79a922d2008-05-17 19:21:20 +00001190 1) < 0)
1191 return NULL;
1192 res = (*nb->nb_hex)(v);
1193 if (res && !PyString_Check(res)) {
1194 PyErr_Format(PyExc_TypeError,
1195 "__hex__ returned non-string (type %.200s)",
1196 res->ob_type->tp_name);
1197 Py_DECREF(res);
1198 return NULL;
1199 }
1200 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001201 }
Benjamin Peterson79a922d2008-05-17 19:21:20 +00001202 else if (PyIndex_Check(v))
1203 return PyNumber_ToBase(v, 16);
1204 PyErr_SetString(PyExc_TypeError,
1205 "hex() argument can't be converted to hex");
1206 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001207}
1208
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001209PyDoc_STRVAR(hex_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001210"hex(number) -> string\n\
1211\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001212Return the hexadecimal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001213
1214
Tim Petersdbd9ba62000-07-09 03:09:57 +00001215static PyObject *builtin_raw_input(PyObject *, PyObject *);
Guido van Rossum3165fe61992-09-25 21:59:05 +00001216
Guido van Rossum79f25d91997-04-29 20:08:16 +00001217static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001218builtin_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001219{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001220 PyObject *line;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001221 char *str;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001222 PyObject *res;
1223 PyObject *globals, *locals;
Hye-Shik Changff83c2b2004-02-02 13:39:01 +00001224 PyCompilerFlags cf;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001225
1226 line = builtin_raw_input(self, args);
Guido van Rossum3165fe61992-09-25 21:59:05 +00001227 if (line == NULL)
1228 return line;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001229 if (!PyArg_Parse(line, "s;embedded '\\0' in input line", &str))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001230 return NULL;
1231 while (*str == ' ' || *str == '\t')
1232 str++;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001233 globals = PyEval_GetGlobals();
1234 locals = PyEval_GetLocals();
1235 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
1236 if (PyDict_SetItemString(globals, "__builtins__",
1237 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +00001238 return NULL;
1239 }
Hye-Shik Changff83c2b2004-02-02 13:39:01 +00001240 cf.cf_flags = 0;
1241 PyEval_MergeCompilerFlags(&cf);
1242 res = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001243 Py_DECREF(line);
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001244 return res;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001245}
1246
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001247PyDoc_STRVAR(input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001248"input([prompt]) -> value\n\
1249\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001250Equivalent to eval(raw_input(prompt)).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001251
1252
Guido van Rossume8811f81997-02-14 15:48:05 +00001253static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001254builtin_intern(PyObject *self, PyObject *args)
Guido van Rossume8811f81997-02-14 15:48:05 +00001255{
1256 PyObject *s;
Guido van Rossum43713e52000-02-29 13:59:29 +00001257 if (!PyArg_ParseTuple(args, "S:intern", &s))
Guido van Rossume8811f81997-02-14 15:48:05 +00001258 return NULL;
Jeremy Hylton4c989dd2004-08-07 19:20:05 +00001259 if (!PyString_CheckExact(s)) {
1260 PyErr_SetString(PyExc_TypeError,
1261 "can't intern subclass of string");
1262 return NULL;
1263 }
Guido van Rossume8811f81997-02-14 15:48:05 +00001264 Py_INCREF(s);
1265 PyString_InternInPlace(&s);
1266 return s;
1267}
1268
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001269PyDoc_STRVAR(intern_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001270"intern(string) -> string\n\
1271\n\
1272``Intern'' the given string. This enters the string in the (global)\n\
1273table of interned strings whose purpose is to speed up dictionary lookups.\n\
1274Return the string itself or the previously interned string object with the\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001275same value.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001276
1277
Guido van Rossum79f25d91997-04-29 20:08:16 +00001278static PyObject *
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001279builtin_iter(PyObject *self, PyObject *args)
1280{
1281 PyObject *v, *w = NULL;
1282
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001283 if (!PyArg_UnpackTuple(args, "iter", 1, 2, &v, &w))
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001284 return NULL;
1285 if (w == NULL)
1286 return PyObject_GetIter(v);
1287 if (!PyCallable_Check(v)) {
1288 PyErr_SetString(PyExc_TypeError,
1289 "iter(v, w): v must be callable");
1290 return NULL;
1291 }
1292 return PyCallIter_New(v, w);
1293}
1294
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001295PyDoc_STRVAR(iter_doc,
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001296"iter(collection) -> iterator\n\
1297iter(callable, sentinel) -> iterator\n\
1298\n\
1299Get an iterator from an object. In the first form, the argument must\n\
1300supply its own iterator, or be a sequence.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001301In the second form, the callable is called until it returns the sentinel.");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001302
1303
1304static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001305builtin_len(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001306{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001307 Py_ssize_t res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001308
Jeremy Hylton03657cf2000-07-12 13:05:33 +00001309 res = PyObject_Size(v);
Guido van Rossum8ea9f4d1998-06-29 22:26:50 +00001310 if (res < 0 && PyErr_Occurred())
1311 return NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001312 return PyInt_FromSsize_t(res);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001313}
1314
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001315PyDoc_STRVAR(len_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001316"len(object) -> integer\n\
1317\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001318Return the number of items of a sequence or mapping.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001319
1320
Guido van Rossum79f25d91997-04-29 20:08:16 +00001321static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001322builtin_locals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +00001323{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001324 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001325
Guido van Rossum79f25d91997-04-29 20:08:16 +00001326 d = PyEval_GetLocals();
Neal Norwitz43bd4db2006-08-12 01:46:42 +00001327 Py_XINCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +00001328 return d;
1329}
1330
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001331PyDoc_STRVAR(locals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001332"locals() -> dictionary\n\
1333\n\
Raymond Hettinger69bf8f32003-01-04 02:16:22 +00001334Update and return a dictionary containing the current scope's local variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001335
1336
Guido van Rossum79f25d91997-04-29 20:08:16 +00001337static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001338min_max(PyObject *args, PyObject *kwds, int op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001339{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001340 PyObject *v, *it, *item, *val, *maxitem, *maxval, *keyfunc=NULL;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001341 const char *name = op == Py_LT ? "min" : "max";
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001342
Guido van Rossum79f25d91997-04-29 20:08:16 +00001343 if (PyTuple_Size(args) > 1)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001344 v = args;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001345 else if (!PyArg_UnpackTuple(args, (char *)name, 1, 1, &v))
Guido van Rossum3f5da241990-12-20 15:06:42 +00001346 return NULL;
Tim Peters67d687a2002-04-29 21:27:32 +00001347
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001348 if (kwds != NULL && PyDict_Check(kwds) && PyDict_Size(kwds)) {
1349 keyfunc = PyDict_GetItemString(kwds, "key");
1350 if (PyDict_Size(kwds)!=1 || keyfunc == NULL) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001351 PyErr_Format(PyExc_TypeError,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001352 "%s() got an unexpected keyword argument", name);
1353 return NULL;
1354 }
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001355 Py_INCREF(keyfunc);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001356 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001357
Tim Petersc3074532001-05-03 07:00:32 +00001358 it = PyObject_GetIter(v);
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001359 if (it == NULL) {
1360 Py_XDECREF(keyfunc);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001361 return NULL;
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001362 }
Tim Petersc3074532001-05-03 07:00:32 +00001363
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001364 maxitem = NULL; /* the result */
1365 maxval = NULL; /* the value associated with the result */
Brett Cannon9e635cf2004-12-07 00:25:35 +00001366 while (( item = PyIter_Next(it) )) {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001367 /* get the value from the key function */
1368 if (keyfunc != NULL) {
1369 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1370 if (val == NULL)
1371 goto Fail_it_item;
1372 }
1373 /* no key function; the value is the item */
1374 else {
1375 val = item;
1376 Py_INCREF(val);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001377 }
Tim Petersc3074532001-05-03 07:00:32 +00001378
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001379 /* maximum value and item are unset; set them */
1380 if (maxval == NULL) {
1381 maxitem = item;
1382 maxval = val;
1383 }
1384 /* maximum value and item are set; update them as necessary */
Guido van Rossum2d951851994-08-29 12:52:16 +00001385 else {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001386 int cmp = PyObject_RichCompareBool(val, maxval, op);
1387 if (cmp < 0)
1388 goto Fail_it_item_and_val;
1389 else if (cmp > 0) {
1390 Py_DECREF(maxval);
1391 Py_DECREF(maxitem);
1392 maxval = val;
1393 maxitem = item;
Guido van Rossum53451b32001-01-17 15:47:24 +00001394 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001395 else {
1396 Py_DECREF(item);
1397 Py_DECREF(val);
Guido van Rossumc8b6df91997-05-23 00:06:51 +00001398 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001399 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001400 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001401 if (PyErr_Occurred())
1402 goto Fail_it;
1403 if (maxval == NULL) {
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001404 PyErr_Format(PyExc_ValueError,
1405 "%s() arg is an empty sequence", name);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001406 assert(maxitem == NULL);
1407 }
1408 else
1409 Py_DECREF(maxval);
Tim Petersc3074532001-05-03 07:00:32 +00001410 Py_DECREF(it);
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001411 Py_XDECREF(keyfunc);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001412 return maxitem;
1413
1414Fail_it_item_and_val:
1415 Py_DECREF(val);
1416Fail_it_item:
1417 Py_DECREF(item);
1418Fail_it:
1419 Py_XDECREF(maxval);
1420 Py_XDECREF(maxitem);
1421 Py_DECREF(it);
Guido van Rossum1d9a9ea2008-01-23 20:19:01 +00001422 Py_XDECREF(keyfunc);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001423 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001424}
1425
Guido van Rossum79f25d91997-04-29 20:08:16 +00001426static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001427builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001428{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001429 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001430}
1431
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001432PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001433"min(iterable[, key=func]) -> value\n\
1434min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001435\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001436With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001437With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001438
1439
Guido van Rossum79f25d91997-04-29 20:08:16 +00001440static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001441builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001442{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001443 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001444}
1445
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001446PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001447"max(iterable[, key=func]) -> value\n\
1448max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001449\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001450With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001451With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001452
1453
Guido van Rossum79f25d91997-04-29 20:08:16 +00001454static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001455builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001456{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001457 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001458 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001459
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001460 if (v == NULL || (nb = v->ob_type->tp_as_number) == NULL ||
1461 nb->nb_oct == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001462 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001463 "oct() argument can't be converted to oct");
1464 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001465 }
Benjamin Peterson79a922d2008-05-17 19:21:20 +00001466 if (PyErr_WarnPy3k("In 3.x, oct() converts the result of __index__ to octal; "
1467 "Use future_builtins.oct for this behavior. "
1468 "Also, note the returned format is different.",
1469 1) < 0)
1470 return NULL;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001471 res = (*nb->nb_oct)(v);
1472 if (res && !PyString_Check(res)) {
1473 PyErr_Format(PyExc_TypeError,
1474 "__oct__ returned non-string (type %.200s)",
1475 res->ob_type->tp_name);
1476 Py_DECREF(res);
1477 return NULL;
1478 }
1479 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001480}
1481
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001482PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001483"oct(number) -> string\n\
1484\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001485Return the octal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001486
1487
Guido van Rossum79f25d91997-04-29 20:08:16 +00001488static PyObject *
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00001489builtin_open(PyObject *self, PyObject *args, PyObject *kwds)
1490{
1491 return PyObject_Call((PyObject*)&PyFile_Type, args, kwds);
1492}
1493
1494PyDoc_STRVAR(open_doc,
1495"open(name[, mode[, buffering]]) -> file object\n\
1496\n\
Skip Montanaro4e3ebe02007-12-08 14:37:43 +00001497Open a file using the file() type, returns a file object. This is the\n\
1498preferred way to open a file.");
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00001499
1500
1501static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001502builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001503{
Guido van Rossum09095f32000-03-10 23:00:52 +00001504 long ord;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001505 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001506
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001507 if (PyString_Check(obj)) {
1508 size = PyString_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001509 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001510 ord = (long)((unsigned char)*PyString_AS_STRING(obj));
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001511 return PyInt_FromLong(ord);
1512 }
Christian Heimes1a6387e2008-03-26 12:49:49 +00001513 } else if (PyBytes_Check(obj)) {
1514 size = PyBytes_GET_SIZE(obj);
1515 if (size == 1) {
1516 ord = (long)((unsigned char)*PyBytes_AS_STRING(obj));
1517 return PyInt_FromLong(ord);
1518 }
1519
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001520#ifdef Py_USING_UNICODE
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001521 } else if (PyUnicode_Check(obj)) {
1522 size = PyUnicode_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001523 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001524 ord = (long)*PyUnicode_AS_UNICODE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001525 return PyInt_FromLong(ord);
1526 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001527#endif
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001528 } else {
1529 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001530 "ord() expected string of length 1, but " \
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001531 "%.200s found", obj->ob_type->tp_name);
Guido van Rossum09095f32000-03-10 23:00:52 +00001532 return NULL;
1533 }
1534
Guido van Rossumad991772001-01-12 16:03:05 +00001535 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001536 "ord() expected a character, "
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001537 "but string of length %zd found",
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001538 size);
1539 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001540}
1541
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001542PyDoc_STRVAR(ord_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001543"ord(c) -> integer\n\
1544\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001545Return the integer ordinal of a one-character string.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001546
1547
Guido van Rossum79f25d91997-04-29 20:08:16 +00001548static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001549builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001550{
Guido van Rossum09df08a1998-05-22 00:51:39 +00001551 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001552
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001553 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001554 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +00001555 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001556}
1557
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001558PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001559"pow(x, y[, z]) -> number\n\
1560\n\
1561With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001562equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001563
1564
Eric Smith7c478942008-03-18 23:45:49 +00001565static PyObject *
1566builtin_print(PyObject *self, PyObject *args, PyObject *kwds)
1567{
1568 static char *kwlist[] = {"sep", "end", "file", 0};
1569 static PyObject *dummy_args;
1570 PyObject *sep = NULL, *end = NULL, *file = NULL;
1571 int i, err;
1572
1573 if (dummy_args == NULL) {
1574 if (!(dummy_args = PyTuple_New(0)))
1575 return NULL;
1576 }
1577 if (!PyArg_ParseTupleAndKeywords(dummy_args, kwds, "|OOO:print",
1578 kwlist, &sep, &end, &file))
1579 return NULL;
1580 if (file == NULL || file == Py_None) {
1581 file = PySys_GetObject("stdout");
1582 /* sys.stdout may be None when FILE* stdout isn't connected */
1583 if (file == Py_None)
1584 Py_RETURN_NONE;
1585 }
1586
1587 if (sep && sep != Py_None && !PyString_Check(sep) &&
1588 !PyUnicode_Check(sep)) {
1589 PyErr_Format(PyExc_TypeError,
1590 "sep must be None, str or unicode, not %.200s",
1591 sep->ob_type->tp_name);
1592 return NULL;
1593 }
1594 if (end && end != Py_None && !PyString_Check(end) &&
1595 !PyUnicode_Check(end)) {
1596 PyErr_Format(PyExc_TypeError,
1597 "end must be None, str or unicode, not %.200s",
1598 end->ob_type->tp_name);
1599 return NULL;
1600 }
1601
1602 for (i = 0; i < PyTuple_Size(args); i++) {
1603 if (i > 0) {
1604 if (sep == NULL || sep == Py_None)
1605 err = PyFile_WriteString(" ", file);
1606 else
1607 err = PyFile_WriteObject(sep, file,
1608 Py_PRINT_RAW);
1609 if (err)
1610 return NULL;
1611 }
1612 err = PyFile_WriteObject(PyTuple_GetItem(args, i), file,
1613 Py_PRINT_RAW);
1614 if (err)
1615 return NULL;
1616 }
1617
1618 if (end == NULL || end == Py_None)
1619 err = PyFile_WriteString("\n", file);
1620 else
1621 err = PyFile_WriteObject(end, file, Py_PRINT_RAW);
1622 if (err)
1623 return NULL;
1624
1625 Py_RETURN_NONE;
1626}
1627
1628PyDoc_STRVAR(print_doc,
1629"print(value, ..., sep=' ', end='\\n', file=sys.stdout)\n\
1630\n\
1631Prints the values to a stream, or to sys.stdout by default.\n\
1632Optional keyword arguments:\n\
1633file: a file-like object (stream); defaults to the current sys.stdout.\n\
1634sep: string inserted between values, default a space.\n\
1635end: string appended after the last value, default a newline.");
1636
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001637
1638/* Return number of items in range (lo, hi, step), when arguments are
1639 * PyInt or PyLong objects. step > 0 required. Return a value < 0 if
1640 * & only if the true value is too large to fit in a signed long.
1641 * Arguments MUST return 1 with either PyInt_Check() or
1642 * PyLong_Check(). Return -1 when there is an error.
1643 */
1644static long
1645get_len_of_range_longs(PyObject *lo, PyObject *hi, PyObject *step)
1646{
1647 /* -------------------------------------------------------------
1648 Algorithm is equal to that of get_len_of_range(), but it operates
1649 on PyObjects (which are assumed to be PyLong or PyInt objects).
1650 ---------------------------------------------------------------*/
1651 long n;
1652 PyObject *diff = NULL;
1653 PyObject *one = NULL;
1654 PyObject *tmp1 = NULL, *tmp2 = NULL, *tmp3 = NULL;
1655 /* holds sub-expression evaluations */
1656
1657 /* if (lo >= hi), return length of 0. */
1658 if (PyObject_Compare(lo, hi) >= 0)
1659 return 0;
1660
1661 if ((one = PyLong_FromLong(1L)) == NULL)
1662 goto Fail;
1663
1664 if ((tmp1 = PyNumber_Subtract(hi, lo)) == NULL)
1665 goto Fail;
1666
1667 if ((diff = PyNumber_Subtract(tmp1, one)) == NULL)
1668 goto Fail;
1669
1670 if ((tmp2 = PyNumber_FloorDivide(diff, step)) == NULL)
1671 goto Fail;
1672
1673 if ((tmp3 = PyNumber_Add(tmp2, one)) == NULL)
1674 goto Fail;
1675
1676 n = PyLong_AsLong(tmp3);
1677 if (PyErr_Occurred()) { /* Check for Overflow */
1678 PyErr_Clear();
1679 goto Fail;
1680 }
1681
1682 Py_DECREF(tmp3);
1683 Py_DECREF(tmp2);
1684 Py_DECREF(diff);
1685 Py_DECREF(tmp1);
1686 Py_DECREF(one);
1687 return n;
1688
1689 Fail:
1690 Py_XDECREF(tmp3);
1691 Py_XDECREF(tmp2);
1692 Py_XDECREF(diff);
1693 Py_XDECREF(tmp1);
1694 Py_XDECREF(one);
1695 return -1;
1696}
1697
1698/* An extension of builtin_range() that handles the case when PyLong
1699 * arguments are given. */
1700static PyObject *
1701handle_range_longs(PyObject *self, PyObject *args)
1702{
1703 PyObject *ilow;
Tim Peters874e1f72003-04-13 22:13:08 +00001704 PyObject *ihigh = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001705 PyObject *istep = NULL;
Tim Peters874e1f72003-04-13 22:13:08 +00001706
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001707 PyObject *curnum = NULL;
1708 PyObject *v = NULL;
1709 long bign;
1710 int i, n;
1711 int cmp_result;
1712
Tim Peters874e1f72003-04-13 22:13:08 +00001713 PyObject *zero = PyLong_FromLong(0);
1714
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001715 if (zero == NULL)
1716 return NULL;
1717
Tim Peters874e1f72003-04-13 22:13:08 +00001718 if (!PyArg_UnpackTuple(args, "range", 1, 3, &ilow, &ihigh, &istep)) {
1719 Py_DECREF(zero);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001720 return NULL;
1721 }
1722
Tim Peters874e1f72003-04-13 22:13:08 +00001723 /* Figure out which way we were called, supply defaults, and be
1724 * sure to incref everything so that the decrefs at the end
1725 * are correct.
1726 */
1727 assert(ilow != NULL);
1728 if (ihigh == NULL) {
1729 /* only 1 arg -- it's the upper limit */
1730 ihigh = ilow;
1731 ilow = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001732 }
Tim Peters874e1f72003-04-13 22:13:08 +00001733 assert(ihigh != NULL);
1734 Py_INCREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001735
Tim Peters874e1f72003-04-13 22:13:08 +00001736 /* ihigh correct now; do ilow */
1737 if (ilow == NULL)
1738 ilow = zero;
1739 Py_INCREF(ilow);
1740
1741 /* ilow and ihigh correct now; do istep */
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001742 if (istep == NULL) {
1743 istep = PyLong_FromLong(1L);
1744 if (istep == NULL)
1745 goto Fail;
1746 }
1747 else {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001748 Py_INCREF(istep);
1749 }
1750
Tim Peters874e1f72003-04-13 22:13:08 +00001751 if (!PyInt_Check(ilow) && !PyLong_Check(ilow)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001752 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001753 "range() integer start argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001754 ilow->ob_type->tp_name);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001755 goto Fail;
1756 }
1757
Tim Peters874e1f72003-04-13 22:13:08 +00001758 if (!PyInt_Check(ihigh) && !PyLong_Check(ihigh)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001759 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001760 "range() integer end argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001761 ihigh->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001762 goto Fail;
1763 }
1764
1765 if (!PyInt_Check(istep) && !PyLong_Check(istep)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001766 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001767 "range() integer step argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001768 istep->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001769 goto Fail;
1770 }
1771
1772 if (PyObject_Cmp(istep, zero, &cmp_result) == -1)
1773 goto Fail;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001774 if (cmp_result == 0) {
1775 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001776 "range() step argument must not be zero");
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001777 goto Fail;
1778 }
1779
1780 if (cmp_result > 0)
1781 bign = get_len_of_range_longs(ilow, ihigh, istep);
1782 else {
1783 PyObject *neg_istep = PyNumber_Negative(istep);
1784 if (neg_istep == NULL)
1785 goto Fail;
1786 bign = get_len_of_range_longs(ihigh, ilow, neg_istep);
1787 Py_DECREF(neg_istep);
1788 }
1789
1790 n = (int)bign;
1791 if (bign < 0 || (long)n != bign) {
1792 PyErr_SetString(PyExc_OverflowError,
1793 "range() result has too many items");
1794 goto Fail;
1795 }
1796
1797 v = PyList_New(n);
1798 if (v == NULL)
1799 goto Fail;
1800
1801 curnum = ilow;
1802 Py_INCREF(curnum);
1803
1804 for (i = 0; i < n; i++) {
1805 PyObject *w = PyNumber_Long(curnum);
1806 PyObject *tmp_num;
1807 if (w == NULL)
1808 goto Fail;
1809
1810 PyList_SET_ITEM(v, i, w);
1811
1812 tmp_num = PyNumber_Add(curnum, istep);
1813 if (tmp_num == NULL)
1814 goto Fail;
1815
1816 Py_DECREF(curnum);
1817 curnum = tmp_num;
1818 }
Tim Peters874e1f72003-04-13 22:13:08 +00001819 Py_DECREF(ilow);
1820 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001821 Py_DECREF(istep);
1822 Py_DECREF(zero);
Tim Peters874e1f72003-04-13 22:13:08 +00001823 Py_DECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001824 return v;
1825
1826 Fail:
Tim Peters874e1f72003-04-13 22:13:08 +00001827 Py_DECREF(ilow);
1828 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001829 Py_XDECREF(istep);
Tim Peters874e1f72003-04-13 22:13:08 +00001830 Py_DECREF(zero);
1831 Py_XDECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001832 Py_XDECREF(v);
1833 return NULL;
1834}
1835
Guido van Rossum124eff01999-02-23 16:11:01 +00001836/* Return number of items in range/xrange (lo, hi, step). step > 0
1837 * required. Return a value < 0 if & only if the true value is too
1838 * large to fit in a signed long.
1839 */
1840static long
Thomas Wouterse28c2962000-07-23 22:21:32 +00001841get_len_of_range(long lo, long hi, long step)
Guido van Rossum124eff01999-02-23 16:11:01 +00001842{
1843 /* -------------------------------------------------------------
1844 If lo >= hi, the range is empty.
1845 Else if n values are in the range, the last one is
1846 lo + (n-1)*step, which must be <= hi-1. Rearranging,
1847 n <= (hi - lo - 1)/step + 1, so taking the floor of the RHS gives
1848 the proper value. Since lo < hi in this case, hi-lo-1 >= 0, so
1849 the RHS is non-negative and so truncation is the same as the
1850 floor. Letting M be the largest positive long, the worst case
1851 for the RHS numerator is hi=M, lo=-M-1, and then
1852 hi-lo-1 = M-(-M-1)-1 = 2*M. Therefore unsigned long has enough
1853 precision to compute the RHS exactly.
1854 ---------------------------------------------------------------*/
1855 long n = 0;
1856 if (lo < hi) {
1857 unsigned long uhi = (unsigned long)hi;
1858 unsigned long ulo = (unsigned long)lo;
1859 unsigned long diff = uhi - ulo - 1;
1860 n = (long)(diff / (unsigned long)step + 1);
1861 }
1862 return n;
1863}
1864
Guido van Rossum79f25d91997-04-29 20:08:16 +00001865static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001866builtin_range(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001867{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001868 long ilow = 0, ihigh = 0, istep = 1;
Guido van Rossum124eff01999-02-23 16:11:01 +00001869 long bign;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001870 int i, n;
Guido van Rossum124eff01999-02-23 16:11:01 +00001871
Guido van Rossum79f25d91997-04-29 20:08:16 +00001872 PyObject *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001873
Guido van Rossum79f25d91997-04-29 20:08:16 +00001874 if (PyTuple_Size(args) <= 1) {
1875 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001876 "l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001877 &ihigh)) {
1878 PyErr_Clear();
1879 return handle_range_longs(self, args);
1880 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001881 }
1882 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001883 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001884 "ll|l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001885 &ilow, &ihigh, &istep)) {
1886 PyErr_Clear();
1887 return handle_range_longs(self, args);
1888 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001889 }
1890 if (istep == 0) {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001891 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001892 "range() step argument must not be zero");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001893 return NULL;
1894 }
Guido van Rossum124eff01999-02-23 16:11:01 +00001895 if (istep > 0)
1896 bign = get_len_of_range(ilow, ihigh, istep);
1897 else
1898 bign = get_len_of_range(ihigh, ilow, -istep);
1899 n = (int)bign;
1900 if (bign < 0 || (long)n != bign) {
Guido van Rossume23cde21999-01-12 05:07:47 +00001901 PyErr_SetString(PyExc_OverflowError,
Fred Drake661ea262000-10-24 19:57:45 +00001902 "range() result has too many items");
Guido van Rossume23cde21999-01-12 05:07:47 +00001903 return NULL;
1904 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001905 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001906 if (v == NULL)
1907 return NULL;
1908 for (i = 0; i < n; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001909 PyObject *w = PyInt_FromLong(ilow);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001910 if (w == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001911 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001912 return NULL;
1913 }
Guido van Rossuma937d141998-04-24 18:22:02 +00001914 PyList_SET_ITEM(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001915 ilow += istep;
1916 }
1917 return v;
1918}
1919
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001920PyDoc_STRVAR(range_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001921"range([start,] stop[, step]) -> list of integers\n\
1922\n\
1923Return a list containing an arithmetic progression of integers.\n\
1924range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.\n\
1925When step is given, it specifies the increment (or decrement).\n\
1926For example, range(4) returns [0, 1, 2, 3]. The end point is omitted!\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001927These are exactly the valid indices for a list of 4 elements.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001928
1929
Guido van Rossum79f25d91997-04-29 20:08:16 +00001930static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001931builtin_raw_input(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001932{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001933 PyObject *v = NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001934 PyObject *fin = PySys_GetObject("stdin");
1935 PyObject *fout = PySys_GetObject("stdout");
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001936
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001937 if (!PyArg_UnpackTuple(args, "[raw_]input", 0, 1, &v))
Guido van Rossum3165fe61992-09-25 21:59:05 +00001938 return NULL;
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001939
1940 if (fin == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001941 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdin");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001942 return NULL;
1943 }
1944 if (fout == NULL) {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001945 PyErr_SetString(PyExc_RuntimeError, "[raw_]input: lost sys.stdout");
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001946 return NULL;
1947 }
1948 if (PyFile_SoftSpace(fout, 0)) {
1949 if (PyFile_WriteString(" ", fout) != 0)
1950 return NULL;
1951 }
Georg Brandl7e3ba2a2006-08-06 08:23:54 +00001952 if (PyFile_AsFile(fin) && PyFile_AsFile(fout)
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001953 && isatty(fileno(PyFile_AsFile(fin)))
1954 && isatty(fileno(PyFile_AsFile(fout)))) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001955 PyObject *po;
Guido van Rossum872537c1995-07-07 22:43:42 +00001956 char *prompt;
1957 char *s;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001958 PyObject *result;
Guido van Rossum872537c1995-07-07 22:43:42 +00001959 if (v != NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001960 po = PyObject_Str(v);
Guido van Rossum872537c1995-07-07 22:43:42 +00001961 if (po == NULL)
1962 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001963 prompt = PyString_AsString(po);
Guido van Rossumd9b52081998-06-26 18:25:38 +00001964 if (prompt == NULL)
1965 return NULL;
Guido van Rossum872537c1995-07-07 22:43:42 +00001966 }
1967 else {
1968 po = NULL;
1969 prompt = "";
1970 }
Michael W. Hudson52db5192004-08-02 13:21:09 +00001971 s = PyOS_Readline(PyFile_AsFile(fin), PyFile_AsFile(fout),
Martin v. Löwis566f6af2002-10-26 14:39:10 +00001972 prompt);
Guido van Rossum79f25d91997-04-29 20:08:16 +00001973 Py_XDECREF(po);
Guido van Rossum872537c1995-07-07 22:43:42 +00001974 if (s == NULL) {
Michael W. Hudson30ea2f22004-07-07 17:44:12 +00001975 if (!PyErr_Occurred())
1976 PyErr_SetNone(PyExc_KeyboardInterrupt);
Guido van Rossum872537c1995-07-07 22:43:42 +00001977 return NULL;
1978 }
1979 if (*s == '\0') {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001980 PyErr_SetNone(PyExc_EOFError);
Guido van Rossum872537c1995-07-07 22:43:42 +00001981 result = NULL;
1982 }
1983 else { /* strip trailing '\n' */
Guido van Rossum106f2da2000-06-28 21:12:25 +00001984 size_t len = strlen(s);
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00001985 if (len > PY_SSIZE_T_MAX) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001986 PyErr_SetString(PyExc_OverflowError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001987 "[raw_]input: input too long");
Guido van Rossum106f2da2000-06-28 21:12:25 +00001988 result = NULL;
1989 }
1990 else {
Martin v. Löwisb1ed7fa2006-04-13 07:52:27 +00001991 result = PyString_FromStringAndSize(s, len-1);
Guido van Rossum106f2da2000-06-28 21:12:25 +00001992 }
Guido van Rossum872537c1995-07-07 22:43:42 +00001993 }
Guido van Rossumb18618d2000-05-03 23:44:39 +00001994 PyMem_FREE(s);
Guido van Rossum872537c1995-07-07 22:43:42 +00001995 return result;
1996 }
Guido van Rossum90933611991-06-07 16:10:43 +00001997 if (v != NULL) {
Martin v. Löwis31d2df52002-08-14 15:46:02 +00001998 if (PyFile_WriteObject(v, fout, Py_PRINT_RAW) != 0)
Guido van Rossum90933611991-06-07 16:10:43 +00001999 return NULL;
2000 }
Martin v. Löwis31d2df52002-08-14 15:46:02 +00002001 return PyFile_GetLine(fin, -1);
Guido van Rossum3f5da241990-12-20 15:06:42 +00002002}
2003
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002004PyDoc_STRVAR(raw_input_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002005"raw_input([prompt]) -> string\n\
2006\n\
2007Read a string from standard input. The trailing newline is stripped.\n\
2008If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
2009On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002010is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002011
2012
Guido van Rossum79f25d91997-04-29 20:08:16 +00002013static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002014builtin_reduce(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002015{
Tim Peters15d81ef2001-05-04 04:39:21 +00002016 PyObject *seq, *func, *result = NULL, *it;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002017
Benjamin Peterson9f4f4812008-04-27 03:01:45 +00002018 if (PyErr_WarnPy3k("reduce() not supported in 3.x; "
Benjamin Petersonf19a7b92008-04-27 18:40:21 +00002019 "use functools.reduce()", 1) < 0)
Neal Norwitzdf25efe2007-05-23 06:58:36 +00002020 return NULL;
2021
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002022 if (!PyArg_UnpackTuple(args, "reduce", 2, 3, &func, &seq, &result))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002023 return NULL;
2024 if (result != NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002025 Py_INCREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002026
Tim Peters15d81ef2001-05-04 04:39:21 +00002027 it = PyObject_GetIter(seq);
2028 if (it == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002029 PyErr_SetString(PyExc_TypeError,
Tim Peters15d81ef2001-05-04 04:39:21 +00002030 "reduce() arg 2 must support iteration");
2031 Py_XDECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002032 return NULL;
2033 }
2034
Guido van Rossum79f25d91997-04-29 20:08:16 +00002035 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00002036 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002037
Tim Peters15d81ef2001-05-04 04:39:21 +00002038 for (;;) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002039 PyObject *op2;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002040
2041 if (args->ob_refcnt > 1) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002042 Py_DECREF(args);
2043 if ((args = PyTuple_New(2)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00002044 goto Fail;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002045 }
2046
Tim Peters15d81ef2001-05-04 04:39:21 +00002047 op2 = PyIter_Next(it);
2048 if (op2 == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +00002049 if (PyErr_Occurred())
2050 goto Fail;
2051 break;
Guido van Rossum2d951851994-08-29 12:52:16 +00002052 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002053
Guido van Rossum2d951851994-08-29 12:52:16 +00002054 if (result == NULL)
2055 result = op2;
2056 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002057 PyTuple_SetItem(args, 0, result);
2058 PyTuple_SetItem(args, 1, op2);
2059 if ((result = PyEval_CallObject(func, args)) == NULL)
Guido van Rossum2d951851994-08-29 12:52:16 +00002060 goto Fail;
2061 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002062 }
2063
Guido van Rossum79f25d91997-04-29 20:08:16 +00002064 Py_DECREF(args);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002065
Guido van Rossum2d951851994-08-29 12:52:16 +00002066 if (result == NULL)
Guido van Rossum79f25d91997-04-29 20:08:16 +00002067 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +00002068 "reduce() of empty sequence with no initial value");
Guido van Rossum2d951851994-08-29 12:52:16 +00002069
Tim Peters15d81ef2001-05-04 04:39:21 +00002070 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002071 return result;
2072
Guido van Rossum2d951851994-08-29 12:52:16 +00002073Fail:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002074 Py_XDECREF(args);
2075 Py_XDECREF(result);
Tim Peters15d81ef2001-05-04 04:39:21 +00002076 Py_DECREF(it);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002077 return NULL;
2078}
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;
2140 if (number >= 0.0)
2141 number = floor(number + 0.5);
2142 else
2143 number = ceil(number - 0.5);
2144 if (ndigits < 0)
2145 number *= f;
2146 else
2147 number /= f;
2148 return PyFloat_FromDouble(number);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00002149}
2150
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002151PyDoc_STRVAR(round_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002152"round(number[, ndigits]) -> floating point number\n\
2153\n\
2154Round a number to a given precision in decimal digits (default 0 digits).\n\
Jeffrey Yasskin9871d8f2008-01-05 08:47:13 +00002155This always returns a floating point number. Precision may be negative.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002156
Raymond Hettinger64958a12003-12-17 20:43:33 +00002157static PyObject *
2158builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
2159{
2160 PyObject *newlist, *v, *seq, *compare=NULL, *keyfunc=NULL, *newargs;
2161 PyObject *callable;
Martin v. Löwis15e62742006-02-27 16:46:16 +00002162 static char *kwlist[] = {"iterable", "cmp", "key", "reverse", 0};
Neal Norwitz6f0d4792005-12-15 06:40:36 +00002163 int reverse;
Raymond Hettinger64958a12003-12-17 20:43:33 +00002164
Neal Norwitz6f0d4792005-12-15 06:40:36 +00002165 /* args 1-4 should match listsort in Objects/listobject.c */
Armin Rigo71d7e702005-09-20 18:13:03 +00002166 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|OOi:sorted",
2167 kwlist, &seq, &compare, &keyfunc, &reverse))
2168 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00002169
2170 newlist = PySequence_List(seq);
2171 if (newlist == NULL)
2172 return NULL;
2173
2174 callable = PyObject_GetAttrString(newlist, "sort");
2175 if (callable == NULL) {
2176 Py_DECREF(newlist);
2177 return NULL;
2178 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002179
Raymond Hettinger64958a12003-12-17 20:43:33 +00002180 newargs = PyTuple_GetSlice(args, 1, 4);
2181 if (newargs == NULL) {
2182 Py_DECREF(newlist);
2183 Py_DECREF(callable);
2184 return NULL;
2185 }
2186
2187 v = PyObject_Call(callable, newargs, kwds);
2188 Py_DECREF(newargs);
2189 Py_DECREF(callable);
2190 if (v == NULL) {
2191 Py_DECREF(newlist);
2192 return NULL;
2193 }
2194 Py_DECREF(v);
2195 return newlist;
2196}
2197
2198PyDoc_STRVAR(sorted_doc,
2199"sorted(iterable, cmp=None, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002200
Guido van Rossum79f25d91997-04-29 20:08:16 +00002201static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002202builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00002203{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002204 PyObject *v = NULL;
2205 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002206
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002207 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00002208 return NULL;
Guido van Rossum2d951851994-08-29 12:52:16 +00002209 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002210 d = PyEval_GetLocals();
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00002211 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002212 if (!PyErr_Occurred())
2213 PyErr_SetString(PyExc_SystemError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002214 "vars(): no locals!?");
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00002215 }
2216 else
Guido van Rossum79f25d91997-04-29 20:08:16 +00002217 Py_INCREF(d);
Guido van Rossum2d951851994-08-29 12:52:16 +00002218 }
2219 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002220 d = PyObject_GetAttrString(v, "__dict__");
Guido van Rossum2d951851994-08-29 12:52:16 +00002221 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002222 PyErr_SetString(PyExc_TypeError,
Guido van Rossum2d951851994-08-29 12:52:16 +00002223 "vars() argument must have __dict__ attribute");
2224 return NULL;
2225 }
2226 }
2227 return d;
2228}
2229
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002230PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002231"vars([object]) -> dictionary\n\
2232\n\
2233Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002234With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002235
Alex Martellia70b1912003-04-22 08:12:33 +00002236
2237static PyObject*
2238builtin_sum(PyObject *self, PyObject *args)
2239{
2240 PyObject *seq;
2241 PyObject *result = NULL;
2242 PyObject *temp, *item, *iter;
2243
Raymond Hettinger5cf63942003-10-25 06:41:37 +00002244 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
Alex Martellia70b1912003-04-22 08:12:33 +00002245 return NULL;
2246
2247 iter = PyObject_GetIter(seq);
2248 if (iter == NULL)
2249 return NULL;
2250
2251 if (result == NULL) {
2252 result = PyInt_FromLong(0);
2253 if (result == NULL) {
2254 Py_DECREF(iter);
2255 return NULL;
2256 }
2257 } else {
2258 /* reject string values for 'start' parameter */
2259 if (PyObject_TypeCheck(result, &PyBaseString_Type)) {
2260 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002261 "sum() can't sum strings [use ''.join(seq) instead]");
Alex Martellia70b1912003-04-22 08:12:33 +00002262 Py_DECREF(iter);
2263 return NULL;
2264 }
Alex Martelli41c9f882003-04-22 09:24:48 +00002265 Py_INCREF(result);
Alex Martellia70b1912003-04-22 08:12:33 +00002266 }
2267
Raymond Hettinger3f8caa32007-10-24 01:28:33 +00002268#ifndef SLOW_SUM
2269 /* Fast addition by keeping temporary sums in C instead of new Python objects.
2270 Assumes all inputs are the same type. If the assumption fails, default
2271 to the more general routine.
2272 */
2273 if (PyInt_CheckExact(result)) {
2274 long i_result = PyInt_AS_LONG(result);
2275 Py_DECREF(result);
2276 result = NULL;
2277 while(result == NULL) {
2278 item = PyIter_Next(iter);
2279 if (item == NULL) {
2280 Py_DECREF(iter);
2281 if (PyErr_Occurred())
2282 return NULL;
2283 return PyInt_FromLong(i_result);
2284 }
2285 if (PyInt_CheckExact(item)) {
2286 long b = PyInt_AS_LONG(item);
2287 long x = i_result + b;
2288 if ((x^i_result) >= 0 || (x^b) >= 0) {
2289 i_result = x;
2290 Py_DECREF(item);
2291 continue;
2292 }
2293 }
2294 /* Either overflowed or is not an int. Restore real objects and process normally */
2295 result = PyInt_FromLong(i_result);
2296 temp = PyNumber_Add(result, item);
2297 Py_DECREF(result);
2298 Py_DECREF(item);
2299 result = temp;
2300 if (result == NULL) {
2301 Py_DECREF(iter);
2302 return NULL;
2303 }
2304 }
2305 }
2306
2307 if (PyFloat_CheckExact(result)) {
2308 double f_result = PyFloat_AS_DOUBLE(result);
2309 Py_DECREF(result);
2310 result = NULL;
2311 while(result == NULL) {
2312 item = PyIter_Next(iter);
2313 if (item == NULL) {
2314 Py_DECREF(iter);
2315 if (PyErr_Occurred())
2316 return NULL;
2317 return PyFloat_FromDouble(f_result);
2318 }
2319 if (PyFloat_CheckExact(item)) {
2320 PyFPE_START_PROTECT("add", return 0)
2321 f_result += PyFloat_AS_DOUBLE(item);
Raymond Hettinger3a8daf52007-10-24 02:05:51 +00002322 PyFPE_END_PROTECT(f_result)
Raymond Hettingera45c4872007-10-25 02:26:58 +00002323 Py_DECREF(item);
Raymond Hettinger3a8daf52007-10-24 02:05:51 +00002324 continue;
2325 }
2326 if (PyInt_CheckExact(item)) {
2327 PyFPE_START_PROTECT("add", return 0)
2328 f_result += (double)PyInt_AS_LONG(item);
2329 PyFPE_END_PROTECT(f_result)
Raymond Hettingera45c4872007-10-25 02:26:58 +00002330 Py_DECREF(item);
Raymond Hettinger3f8caa32007-10-24 01:28:33 +00002331 continue;
2332 }
2333 result = PyFloat_FromDouble(f_result);
2334 temp = PyNumber_Add(result, item);
2335 Py_DECREF(result);
2336 Py_DECREF(item);
2337 result = temp;
2338 if (result == NULL) {
2339 Py_DECREF(iter);
2340 return NULL;
2341 }
2342 }
2343 }
2344#endif
2345
Alex Martellia70b1912003-04-22 08:12:33 +00002346 for(;;) {
2347 item = PyIter_Next(iter);
2348 if (item == NULL) {
2349 /* error, or end-of-sequence */
2350 if (PyErr_Occurred()) {
2351 Py_DECREF(result);
2352 result = NULL;
2353 }
2354 break;
2355 }
Alex Martellia253e182003-10-25 23:24:14 +00002356 temp = PyNumber_Add(result, item);
Alex Martellia70b1912003-04-22 08:12:33 +00002357 Py_DECREF(result);
2358 Py_DECREF(item);
2359 result = temp;
2360 if (result == NULL)
2361 break;
2362 }
2363 Py_DECREF(iter);
2364 return result;
2365}
2366
2367PyDoc_STRVAR(sum_doc,
Georg Brandl8134d062006-10-12 12:33:07 +00002368"sum(sequence[, start]) -> value\n\
Alex Martellia70b1912003-04-22 08:12:33 +00002369\n\
2370Returns the sum of a sequence of numbers (NOT strings) plus the value\n\
Georg Brandl8134d062006-10-12 12:33:07 +00002371of parameter 'start' (which defaults to 0). When the sequence is\n\
2372empty, returns start.");
Alex Martellia70b1912003-04-22 08:12:33 +00002373
2374
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002375static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002376builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002377{
2378 PyObject *inst;
2379 PyObject *cls;
Guido van Rossum823649d2001-03-21 18:40:58 +00002380 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002381
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002382 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002383 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002384
Guido van Rossum823649d2001-03-21 18:40:58 +00002385 retval = PyObject_IsInstance(inst, cls);
2386 if (retval < 0)
Guido van Rossumad991772001-01-12 16:03:05 +00002387 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002388 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002389}
2390
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002391PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002392"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002393\n\
2394Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002395With a type as second argument, return whether that is the object's type.\n\
2396The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002397isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002398
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002399
2400static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002401builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002402{
2403 PyObject *derived;
2404 PyObject *cls;
2405 int retval;
2406
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00002407 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002408 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002409
Guido van Rossum823649d2001-03-21 18:40:58 +00002410 retval = PyObject_IsSubclass(derived, cls);
2411 if (retval < 0)
2412 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00002413 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002414}
2415
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002416PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002417"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002418\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002419Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2420When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2421is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002422
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002423
Barry Warsawbd599b52000-08-03 15:45:29 +00002424static PyObject*
2425builtin_zip(PyObject *self, PyObject *args)
2426{
2427 PyObject *ret;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002428 const Py_ssize_t itemsize = PySequence_Length(args);
2429 Py_ssize_t i;
Tim Peters8572b4f2001-05-06 01:05:02 +00002430 PyObject *itlist; /* tuple of iterators */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002431 Py_ssize_t len; /* guess at result length */
Barry Warsawbd599b52000-08-03 15:45:29 +00002432
Raymond Hettingereaef6152003-08-02 07:42:57 +00002433 if (itemsize == 0)
2434 return PyList_New(0);
2435
Barry Warsawbd599b52000-08-03 15:45:29 +00002436 /* args must be a tuple */
2437 assert(PyTuple_Check(args));
2438
Tim Peters39a86c22002-05-12 07:19:38 +00002439 /* Guess at result length: the shortest of the input lengths.
2440 If some argument refuses to say, we refuse to guess too, lest
2441 an argument like xrange(sys.maxint) lead us astray.*/
Tim Peters67d687a2002-04-29 21:27:32 +00002442 len = -1; /* unknown */
2443 for (i = 0; i < itemsize; ++i) {
2444 PyObject *item = PyTuple_GET_ITEM(args, i);
Raymond Hettinger4e2f7142007-12-06 00:56:53 +00002445 Py_ssize_t thislen = _PyObject_LengthHint(item, -1);
Tim Peters39a86c22002-05-12 07:19:38 +00002446 if (thislen < 0) {
Tim Peters39a86c22002-05-12 07:19:38 +00002447 len = -1;
2448 break;
2449 }
Tim Peters67d687a2002-04-29 21:27:32 +00002450 else if (len < 0 || thislen < len)
2451 len = thislen;
2452 }
2453
Tim Peters8572b4f2001-05-06 01:05:02 +00002454 /* allocate result list */
Tim Peters67d687a2002-04-29 21:27:32 +00002455 if (len < 0)
2456 len = 10; /* arbitrary */
2457 if ((ret = PyList_New(len)) == NULL)
Barry Warsawbd599b52000-08-03 15:45:29 +00002458 return NULL;
2459
Tim Peters8572b4f2001-05-06 01:05:02 +00002460 /* obtain iterators */
2461 itlist = PyTuple_New(itemsize);
2462 if (itlist == NULL)
2463 goto Fail_ret;
2464 for (i = 0; i < itemsize; ++i) {
2465 PyObject *item = PyTuple_GET_ITEM(args, i);
2466 PyObject *it = PyObject_GetIter(item);
2467 if (it == NULL) {
2468 if (PyErr_ExceptionMatches(PyExc_TypeError))
2469 PyErr_Format(PyExc_TypeError,
Neal Norwitza361bd82006-02-19 19:31:50 +00002470 "zip argument #%zd must support iteration",
Tim Peters8572b4f2001-05-06 01:05:02 +00002471 i+1);
2472 goto Fail_ret_itlist;
Barry Warsawbd599b52000-08-03 15:45:29 +00002473 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002474 PyTuple_SET_ITEM(itlist, i, it);
2475 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002476
Tim Peters8572b4f2001-05-06 01:05:02 +00002477 /* build result into ret list */
Tim Peters67d687a2002-04-29 21:27:32 +00002478 for (i = 0; ; ++i) {
2479 int j;
Tim Peters8572b4f2001-05-06 01:05:02 +00002480 PyObject *next = PyTuple_New(itemsize);
2481 if (!next)
2482 goto Fail_ret_itlist;
2483
Tim Peters67d687a2002-04-29 21:27:32 +00002484 for (j = 0; j < itemsize; j++) {
2485 PyObject *it = PyTuple_GET_ITEM(itlist, j);
Tim Peters8572b4f2001-05-06 01:05:02 +00002486 PyObject *item = PyIter_Next(it);
Barry Warsawbd599b52000-08-03 15:45:29 +00002487 if (!item) {
Tim Peters8572b4f2001-05-06 01:05:02 +00002488 if (PyErr_Occurred()) {
2489 Py_DECREF(ret);
2490 ret = NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002491 }
2492 Py_DECREF(next);
Tim Peters8572b4f2001-05-06 01:05:02 +00002493 Py_DECREF(itlist);
Tim Peters67d687a2002-04-29 21:27:32 +00002494 goto Done;
Barry Warsawbd599b52000-08-03 15:45:29 +00002495 }
Tim Peters67d687a2002-04-29 21:27:32 +00002496 PyTuple_SET_ITEM(next, j, item);
Barry Warsawbd599b52000-08-03 15:45:29 +00002497 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002498
Tim Peters67d687a2002-04-29 21:27:32 +00002499 if (i < len)
2500 PyList_SET_ITEM(ret, i, next);
2501 else {
2502 int status = PyList_Append(ret, next);
2503 Py_DECREF(next);
2504 ++len;
2505 if (status < 0)
2506 goto Fail_ret_itlist;
2507 }
Barry Warsawbd599b52000-08-03 15:45:29 +00002508 }
Tim Peters8572b4f2001-05-06 01:05:02 +00002509
Tim Peters67d687a2002-04-29 21:27:32 +00002510Done:
2511 if (ret != NULL && i < len) {
2512 /* The list is too big. */
2513 if (PyList_SetSlice(ret, i, len, NULL) < 0)
2514 return NULL;
2515 }
2516 return ret;
2517
Tim Peters8572b4f2001-05-06 01:05:02 +00002518Fail_ret_itlist:
2519 Py_DECREF(itlist);
2520Fail_ret:
2521 Py_DECREF(ret);
2522 return NULL;
Barry Warsawbd599b52000-08-03 15:45:29 +00002523}
2524
2525
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002526PyDoc_STRVAR(zip_doc,
Barry Warsawbd599b52000-08-03 15:45:29 +00002527"zip(seq1 [, seq2 [...]]) -> [(seq1[0], seq2[0] ...), (...)]\n\
2528\n\
2529Return a list of tuples, where each tuple contains the i-th element\n\
2530from each of the argument sequences. The returned list is truncated\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002531in length to the length of the shortest argument sequence.");
Barry Warsawbd599b52000-08-03 15:45:29 +00002532
2533
Guido van Rossum79f25d91997-04-29 20:08:16 +00002534static PyMethodDef builtin_methods[] = {
Neal Norwitz92e212f2006-04-03 04:48:37 +00002535 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002536 {"abs", builtin_abs, METH_O, abs_doc},
Raymond Hettinger96229b12005-03-11 06:49:40 +00002537 {"all", builtin_all, METH_O, all_doc},
2538 {"any", builtin_any, METH_O, any_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002539 {"apply", builtin_apply, METH_VARARGS, apply_doc},
Eric Smith3cd81942008-02-22 16:30:22 +00002540 {"bin", builtin_bin, METH_O, bin_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002541 {"callable", builtin_callable, METH_O, callable_doc},
2542 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2543 {"cmp", builtin_cmp, METH_VARARGS, cmp_doc},
2544 {"coerce", builtin_coerce, METH_VARARGS, coerce_doc},
Georg Brandl5240d742007-03-13 20:46:32 +00002545 {"compile", (PyCFunction)builtin_compile, METH_VARARGS | METH_KEYWORDS, compile_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002546 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2547 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2548 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2549 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2550 {"execfile", builtin_execfile, METH_VARARGS, execfile_doc},
2551 {"filter", builtin_filter, METH_VARARGS, filter_doc},
Eric Smitha9f7d622008-02-17 19:46:49 +00002552 {"format", builtin_format, METH_VARARGS, format_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002553 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2554 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2555 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2556 {"hash", builtin_hash, METH_O, hash_doc},
2557 {"hex", builtin_hex, METH_O, hex_doc},
2558 {"id", builtin_id, METH_O, id_doc},
2559 {"input", builtin_input, METH_VARARGS, input_doc},
2560 {"intern", builtin_intern, METH_VARARGS, intern_doc},
2561 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2562 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2563 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2564 {"len", builtin_len, METH_O, len_doc},
2565 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2566 {"map", builtin_map, METH_VARARGS, map_doc},
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00002567 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2568 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
Georg Brandl28e08732008-04-30 19:47:09 +00002569 {"next", builtin_next, METH_VARARGS, next_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002570 {"oct", builtin_oct, METH_O, oct_doc},
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00002571 {"open", (PyCFunction)builtin_open, METH_VARARGS | METH_KEYWORDS, open_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002572 {"ord", builtin_ord, METH_O, ord_doc},
2573 {"pow", builtin_pow, METH_VARARGS, pow_doc},
Eric Smith7c478942008-03-18 23:45:49 +00002574 {"print", (PyCFunction)builtin_print, METH_VARARGS | METH_KEYWORDS, print_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002575 {"range", builtin_range, METH_VARARGS, range_doc},
2576 {"raw_input", builtin_raw_input, METH_VARARGS, raw_input_doc},
2577 {"reduce", builtin_reduce, METH_VARARGS, reduce_doc},
2578 {"reload", builtin_reload, METH_O, reload_doc},
2579 {"repr", builtin_repr, METH_O, repr_doc},
Georg Brandlccadf842006-03-31 18:54:53 +00002580 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002581 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
Raymond Hettinger64958a12003-12-17 20:43:33 +00002582 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
Alex Martellia70b1912003-04-22 08:12:33 +00002583 {"sum", builtin_sum, METH_VARARGS, sum_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002584#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002585 {"unichr", builtin_unichr, METH_VARARGS, unichr_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002586#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002587 {"vars", builtin_vars, METH_VARARGS, vars_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002588 {"zip", builtin_zip, METH_VARARGS, zip_doc},
Guido van Rossumc02e15c1991-12-16 13:03:00 +00002589 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002590};
2591
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002592PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002593"Built-in functions, exceptions, and other objects.\n\
2594\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002595Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002596
Guido van Rossum25ce5661997-08-02 03:10:38 +00002597PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002598_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002599{
Fred Drake5550de32000-06-20 04:54:19 +00002600 PyObject *mod, *dict, *debug;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002601 mod = Py_InitModule4("__builtin__", builtin_methods,
2602 builtin_doc, (PyObject *)NULL,
2603 PYTHON_API_VERSION);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002604 if (mod == NULL)
2605 return NULL;
2606 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002607
Tim Peters7571a0f2003-03-23 17:52:28 +00002608#ifdef Py_TRACE_REFS
2609 /* __builtin__ exposes a number of statically allocated objects
2610 * that, before this code was added in 2.3, never showed up in
2611 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2612 * result, programs leaking references to None and False (etc)
2613 * couldn't be diagnosed by examining sys.getobjects(0).
2614 */
2615#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2616#else
2617#define ADD_TO_ALL(OBJECT) (void)0
2618#endif
2619
Tim Peters4b7625e2001-09-13 21:37:17 +00002620#define SETBUILTIN(NAME, OBJECT) \
Tim Peters7571a0f2003-03-23 17:52:28 +00002621 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2622 return NULL; \
2623 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002624
2625 SETBUILTIN("None", Py_None);
2626 SETBUILTIN("Ellipsis", Py_Ellipsis);
2627 SETBUILTIN("NotImplemented", Py_NotImplemented);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002628 SETBUILTIN("False", Py_False);
2629 SETBUILTIN("True", Py_True);
Neal Norwitz32a7e7f2002-05-31 19:58:02 +00002630 SETBUILTIN("basestring", &PyBaseString_Type);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002631 SETBUILTIN("bool", &PyBool_Type);
Travis E. Oliphant3781aef2008-03-18 04:44:57 +00002632 /* SETBUILTIN("memoryview", &PyMemoryView_Type); */
Christian Heimes1a6387e2008-03-26 12:49:49 +00002633 SETBUILTIN("bytearray", &PyBytes_Type);
Christian Heimes288e89a2008-01-18 18:24:07 +00002634 SETBUILTIN("bytes", &PyString_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002635 SETBUILTIN("buffer", &PyBuffer_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002636 SETBUILTIN("classmethod", &PyClassMethod_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002637#ifndef WITHOUT_COMPLEX
Tim Peters4b7625e2001-09-13 21:37:17 +00002638 SETBUILTIN("complex", &PyComplex_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002639#endif
Tim Petersa427a2b2001-10-29 22:25:45 +00002640 SETBUILTIN("dict", &PyDict_Type);
Tim Peters67d687a2002-04-29 21:27:32 +00002641 SETBUILTIN("enumerate", &PyEnum_Type);
Neal Norwitzc4edb0e2006-05-02 04:43:14 +00002642 SETBUILTIN("file", &PyFile_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002643 SETBUILTIN("float", &PyFloat_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002644 SETBUILTIN("frozenset", &PyFrozenSet_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002645 SETBUILTIN("property", &PyProperty_Type);
2646 SETBUILTIN("int", &PyInt_Type);
2647 SETBUILTIN("list", &PyList_Type);
2648 SETBUILTIN("long", &PyLong_Type);
2649 SETBUILTIN("object", &PyBaseObject_Type);
Raymond Hettinger85c20a42003-11-06 14:06:48 +00002650 SETBUILTIN("reversed", &PyReversed_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002651 SETBUILTIN("set", &PySet_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002652 SETBUILTIN("slice", &PySlice_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002653 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2654 SETBUILTIN("str", &PyString_Type);
2655 SETBUILTIN("super", &PySuper_Type);
2656 SETBUILTIN("tuple", &PyTuple_Type);
2657 SETBUILTIN("type", &PyType_Type);
Raymond Hettingerc4c453f2002-06-05 23:12:45 +00002658 SETBUILTIN("xrange", &PyRange_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002659#ifdef Py_USING_UNICODE
Tim Peters4b7625e2001-09-13 21:37:17 +00002660 SETBUILTIN("unicode", &PyUnicode_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002661#endif
Guido van Rossum77f6a652002-04-03 22:41:51 +00002662 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
Fred Drake5550de32000-06-20 04:54:19 +00002663 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2664 Py_XDECREF(debug);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002665 return NULL;
Fred Drake5550de32000-06-20 04:54:19 +00002666 }
2667 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002668
Guido van Rossum25ce5661997-08-02 03:10:38 +00002669 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002670#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002671#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002672}
2673
Guido van Rossume77a7571993-11-03 15:01:26 +00002674/* Helper for filter(): filter a tuple through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002675
Guido van Rossum79f25d91997-04-29 20:08:16 +00002676static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002677filtertuple(PyObject *func, PyObject *tuple)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002678{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002679 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002680 Py_ssize_t i, j;
2681 Py_ssize_t len = PyTuple_Size(tuple);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002682
Guido van Rossumb7b45621995-08-04 04:07:45 +00002683 if (len == 0) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002684 if (PyTuple_CheckExact(tuple))
2685 Py_INCREF(tuple);
2686 else
2687 tuple = PyTuple_New(0);
Guido van Rossumb7b45621995-08-04 04:07:45 +00002688 return tuple;
2689 }
2690
Guido van Rossum79f25d91997-04-29 20:08:16 +00002691 if ((result = PyTuple_New(len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002692 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002693
Guido van Rossum12d12c51993-10-26 17:58:25 +00002694 for (i = j = 0; i < len; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002695 PyObject *item, *good;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002696 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002697
Walter Dörwald8dd19322003-02-10 17:36:40 +00002698 if (tuple->ob_type->tp_as_sequence &&
2699 tuple->ob_type->tp_as_sequence->sq_item) {
2700 item = tuple->ob_type->tp_as_sequence->sq_item(tuple, i);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002701 if (item == NULL)
2702 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002703 } else {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002704 PyErr_SetString(PyExc_TypeError, "filter(): unsubscriptable tuple");
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002705 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002706 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002707 if (func == Py_None) {
2708 Py_INCREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002709 good = item;
2710 }
2711 else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002712 PyObject *arg = PyTuple_Pack(1, item);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002713 if (arg == NULL) {
2714 Py_DECREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002715 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002716 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002717 good = PyEval_CallObject(func, arg);
2718 Py_DECREF(arg);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002719 if (good == NULL) {
2720 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002721 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002722 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002723 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002724 ok = PyObject_IsTrue(good);
2725 Py_DECREF(good);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002726 if (ok) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002727 if (PyTuple_SetItem(result, j++, item) < 0)
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002728 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002729 }
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002730 else
2731 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002732 }
2733
Tim Peters4324aa32001-05-28 22:30:08 +00002734 if (_PyTuple_Resize(&result, j) < 0)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002735 return NULL;
2736
Guido van Rossum12d12c51993-10-26 17:58:25 +00002737 return result;
2738
Guido van Rossum12d12c51993-10-26 17:58:25 +00002739Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002740 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002741 return NULL;
2742}
2743
2744
Guido van Rossume77a7571993-11-03 15:01:26 +00002745/* Helper for filter(): filter a string through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002746
Guido van Rossum79f25d91997-04-29 20:08:16 +00002747static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002748filterstring(PyObject *func, PyObject *strobj)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002749{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002750 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002751 Py_ssize_t i, j;
2752 Py_ssize_t len = PyString_Size(strobj);
2753 Py_ssize_t outlen = len;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002754
Guido van Rossum79f25d91997-04-29 20:08:16 +00002755 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002756 /* If it's a real string we can return the original,
2757 * as no character is ever false and __getitem__
2758 * does return this character. If it's a subclass
2759 * we must go through the __getitem__ loop */
2760 if (PyString_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002761 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002762 return strobj;
2763 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002764 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002765 if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002766 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002767
Guido van Rossum12d12c51993-10-26 17:58:25 +00002768 for (i = j = 0; i < len; ++i) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002769 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002770 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002771
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002772 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2773 if (item == NULL)
2774 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002775 if (func==Py_None) {
2776 ok = 1;
2777 } else {
2778 PyObject *arg, *good;
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002779 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002780 if (arg == NULL) {
2781 Py_DECREF(item);
2782 goto Fail_1;
2783 }
2784 good = PyEval_CallObject(func, arg);
2785 Py_DECREF(arg);
2786 if (good == NULL) {
2787 Py_DECREF(item);
2788 goto Fail_1;
2789 }
2790 ok = PyObject_IsTrue(good);
2791 Py_DECREF(good);
Tim Peters388ed082001-04-07 20:34:48 +00002792 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002793 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002794 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002795 if (!PyString_Check(item)) {
2796 PyErr_SetString(PyExc_TypeError, "can't filter str to str:"
2797 " __getitem__ returned different type");
2798 Py_DECREF(item);
2799 goto Fail_1;
2800 }
2801 reslen = PyString_GET_SIZE(item);
2802 if (reslen == 1) {
2803 PyString_AS_STRING(result)[j++] =
2804 PyString_AS_STRING(item)[0];
2805 } else {
2806 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002807 Py_ssize_t need = j + reslen + len-i-1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002808 if (need > outlen) {
2809 /* overallocate, to avoid reallocations */
2810 if (need<2*outlen)
2811 need = 2*outlen;
2812 if (_PyString_Resize(&result, need)) {
2813 Py_DECREF(item);
2814 return NULL;
2815 }
2816 outlen = need;
2817 }
2818 memcpy(
2819 PyString_AS_STRING(result) + j,
2820 PyString_AS_STRING(item),
2821 reslen
2822 );
2823 j += reslen;
2824 }
2825 }
Tim Peters388ed082001-04-07 20:34:48 +00002826 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002827 }
2828
Walter Dörwald903f1e02003-02-04 16:28:00 +00002829 if (j < outlen)
Tim Peters5de98422002-04-27 18:44:32 +00002830 _PyString_Resize(&result, j);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002831
Guido van Rossum12d12c51993-10-26 17:58:25 +00002832 return result;
2833
Guido van Rossum12d12c51993-10-26 17:58:25 +00002834Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002835 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002836 return NULL;
2837}
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002838
2839#ifdef Py_USING_UNICODE
2840/* Helper for filter(): filter a Unicode object through a function */
2841
2842static PyObject *
2843filterunicode(PyObject *func, PyObject *strobj)
2844{
2845 PyObject *result;
Martin v. Löwis725507b2006-03-07 12:08:51 +00002846 register Py_ssize_t i, j;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002847 Py_ssize_t len = PyUnicode_GetSize(strobj);
2848 Py_ssize_t outlen = len;
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002849
2850 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002851 /* If it's a real string we can return the original,
2852 * as no character is ever false and __getitem__
2853 * does return this character. If it's a subclass
2854 * we must go through the __getitem__ loop */
2855 if (PyUnicode_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002856 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002857 return strobj;
2858 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002859 }
2860 if ((result = PyUnicode_FromUnicode(NULL, len)) == NULL)
2861 return NULL;
2862
2863 for (i = j = 0; i < len; ++i) {
2864 PyObject *item, *arg, *good;
2865 int ok;
2866
2867 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2868 if (item == NULL)
2869 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002870 if (func == Py_None) {
2871 ok = 1;
2872 } else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002873 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002874 if (arg == NULL) {
2875 Py_DECREF(item);
2876 goto Fail_1;
2877 }
2878 good = PyEval_CallObject(func, arg);
2879 Py_DECREF(arg);
2880 if (good == NULL) {
2881 Py_DECREF(item);
2882 goto Fail_1;
2883 }
2884 ok = PyObject_IsTrue(good);
2885 Py_DECREF(good);
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002886 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002887 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002888 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002889 if (!PyUnicode_Check(item)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002890 PyErr_SetString(PyExc_TypeError,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002891 "can't filter unicode to unicode:"
2892 " __getitem__ returned different type");
Walter Dörwald903f1e02003-02-04 16:28:00 +00002893 Py_DECREF(item);
2894 goto Fail_1;
2895 }
2896 reslen = PyUnicode_GET_SIZE(item);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002897 if (reslen == 1)
Walter Dörwald903f1e02003-02-04 16:28:00 +00002898 PyUnicode_AS_UNICODE(result)[j++] =
2899 PyUnicode_AS_UNICODE(item)[0];
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002900 else {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002901 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002902 Py_ssize_t need = j + reslen + len - i - 1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002903 if (need > outlen) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002904 /* overallocate,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002905 to avoid reallocations */
2906 if (need < 2 * outlen)
2907 need = 2 * outlen;
Jeremy Hylton364f6be2003-09-16 03:17:16 +00002908 if (PyUnicode_Resize(
2909 &result, need) < 0) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002910 Py_DECREF(item);
Walter Dörwald531e0002003-02-04 16:57:49 +00002911 goto Fail_1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002912 }
2913 outlen = need;
2914 }
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002915 memcpy(PyUnicode_AS_UNICODE(result) + j,
2916 PyUnicode_AS_UNICODE(item),
2917 reslen*sizeof(Py_UNICODE));
Walter Dörwald903f1e02003-02-04 16:28:00 +00002918 j += reslen;
2919 }
2920 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002921 Py_DECREF(item);
2922 }
2923
Walter Dörwald903f1e02003-02-04 16:28:00 +00002924 if (j < outlen)
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002925 PyUnicode_Resize(&result, j);
2926
2927 return result;
2928
2929Fail_1:
2930 Py_DECREF(result);
2931 return NULL;
2932}
2933#endif