blob: 78aeeb7937e144f1897b1e28b58f609ddc781d58 [file] [log] [blame]
Guido van Rossum3f5da241990-12-20 15:06:42 +00001/* Built-in functions */
2
Guido van Rossum79f25d91997-04-29 20:08:16 +00003#include "Python.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00004
5#include "node.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00006#include "code.h"
Guido van Rossum5b722181993-03-30 17:46:03 +00007#include "eval.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00008
Guido van Rossum6bf62da1997-04-11 20:37:35 +00009#include <ctype.h>
10
Guido van Rossume2ae77b2001-10-24 20:42:55 +000011#ifdef RISCOS
12#include "unixstuff.h"
13#endif
14
Mark Hammond26cffde42001-05-14 12:17:34 +000015/* The default encoding used by the platform file system APIs
16 Can remain NULL for all platforms that don't have such a concept
17*/
Martin v. Löwis6238d2b2002-06-30 15:26:10 +000018#if defined(MS_WINDOWS) && defined(HAVE_USABLE_WCHAR_T)
Mark Hammond26cffde42001-05-14 12:17:34 +000019const char *Py_FileSystemDefaultEncoding = "mbcs";
Just van Rossumb9b8e9c2003-02-10 09:22:01 +000020#elif defined(__APPLE__)
21const char *Py_FileSystemDefaultEncoding = "utf-8";
Mark Hammond26cffde42001-05-14 12:17:34 +000022#else
23const char *Py_FileSystemDefaultEncoding = NULL; /* use default */
24#endif
Mark Hammondef8b6542001-05-13 08:04:26 +000025
Guido van Rossum12d12c51993-10-26 17:58:25 +000026/* Forward */
Tim Petersdbd9ba62000-07-09 03:09:57 +000027static PyObject *filterstring(PyObject *, PyObject *);
Martin v. Löwis8afd7572003-01-25 22:46:11 +000028#ifdef Py_USING_UNICODE
29static PyObject *filterunicode(PyObject *, PyObject *);
30#endif
Tim Petersdbd9ba62000-07-09 03:09:57 +000031static PyObject *filtertuple (PyObject *, PyObject *);
Guido van Rossum12d12c51993-10-26 17:58:25 +000032
Guido van Rossum79f25d91997-04-29 20:08:16 +000033static PyObject *
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000034builtin___import__(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +000035{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000036 static char *kwlist[] = {"name", "globals", "locals", "fromlist",
37 "level", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +000038 char *name;
Guido van Rossum79f25d91997-04-29 20:08:16 +000039 PyObject *globals = NULL;
40 PyObject *locals = NULL;
41 PyObject *fromlist = NULL;
Thomas Woutersf7f438b2006-02-28 16:09:29 +000042 int level = -1;
Guido van Rossum1ae940a1995-01-02 19:04:15 +000043
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000044 if (!PyArg_ParseTupleAndKeywords(args, kwds, "s|OOOi:__import__",
45 kwlist, &name, &globals, &locals, &fromlist, &level))
Guido van Rossum1ae940a1995-01-02 19:04:15 +000046 return NULL;
Thomas Woutersf7f438b2006-02-28 16:09:29 +000047 return PyImport_ImportModuleLevel(name, globals, locals,
48 fromlist, level);
Guido van Rossum1ae940a1995-01-02 19:04:15 +000049}
50
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000051PyDoc_STRVAR(import_doc,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000052"__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000053\n\
54Import a module. The globals are only used to determine the context;\n\
55they are not modified. The locals are currently unused. The fromlist\n\
56should be a list of names to emulate ``from name import ...'', or an\n\
57empty list to emulate ``import name''.\n\
58When importing a module from a package, note that __import__('A.B', ...)\n\
59returns package A when fromlist is empty, but its submodule B when\n\
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000060fromlist is not empty. Level is used to determine whether to perform \n\
61absolute or relative imports. -1 is the original strategy of attempting\n\
62both absolute and relative imports, 0 is absolute, a positive number\n\
63is the number of parent directories to search relative to the current module.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000064
Guido van Rossum1ae940a1995-01-02 19:04:15 +000065
Guido van Rossum79f25d91997-04-29 20:08:16 +000066static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +000067builtin_abs(PyObject *self, PyObject *v)
Guido van Rossum1ae940a1995-01-02 19:04:15 +000068{
Guido van Rossum09df08a1998-05-22 00:51:39 +000069 return PyNumber_Absolute(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +000070}
71
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000072PyDoc_STRVAR(abs_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000073"abs(number) -> number\n\
74\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +000075Return the absolute value of the argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +000076
Raymond Hettinger96229b12005-03-11 06:49:40 +000077static PyObject *
78builtin_all(PyObject *self, PyObject *v)
79{
80 PyObject *it, *item;
81
82 it = PyObject_GetIter(v);
83 if (it == NULL)
84 return NULL;
85
86 while ((item = PyIter_Next(it)) != NULL) {
87 int cmp = PyObject_IsTrue(item);
88 Py_DECREF(item);
89 if (cmp < 0) {
90 Py_DECREF(it);
91 return NULL;
92 }
93 if (cmp == 0) {
94 Py_DECREF(it);
95 Py_RETURN_FALSE;
96 }
97 }
98 Py_DECREF(it);
99 if (PyErr_Occurred())
100 return NULL;
101 Py_RETURN_TRUE;
102}
103
104PyDoc_STRVAR(all_doc,
105"all(iterable) -> bool\n\
106\n\
107Return True if bool(x) is True for all values x in the iterable.");
108
109static PyObject *
110builtin_any(PyObject *self, PyObject *v)
111{
112 PyObject *it, *item;
113
114 it = PyObject_GetIter(v);
115 if (it == NULL)
116 return NULL;
117
118 while ((item = PyIter_Next(it)) != NULL) {
119 int cmp = PyObject_IsTrue(item);
120 Py_DECREF(item);
121 if (cmp < 0) {
122 Py_DECREF(it);
123 return NULL;
124 }
125 if (cmp == 1) {
126 Py_DECREF(it);
127 Py_RETURN_TRUE;
128 }
129 }
130 Py_DECREF(it);
131 if (PyErr_Occurred())
132 return NULL;
133 Py_RETURN_FALSE;
134}
135
136PyDoc_STRVAR(any_doc,
137"any(iterable) -> bool\n\
138\n\
139Return True if bool(x) is True for any x in the iterable.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000140
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000141
Guido van Rossum79f25d91997-04-29 20:08:16 +0000142static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000143builtin_callable(PyObject *self, PyObject *v)
Guido van Rossum2d951851994-08-29 12:52:16 +0000144{
Guido van Rossum77f6a652002-04-03 22:41:51 +0000145 return PyBool_FromLong((long)PyCallable_Check(v));
Guido van Rossum2d951851994-08-29 12:52:16 +0000146}
147
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000148PyDoc_STRVAR(callable_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000149"callable(object) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000150\n\
151Return whether the object is callable (i.e., some kind of function).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000152Note that classes are callable, as are instances with a __call__() method.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000153
154
Guido van Rossum79f25d91997-04-29 20:08:16 +0000155static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000156builtin_filter(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000157{
Guido van Rossumc7903a12002-08-16 07:04:56 +0000158 PyObject *func, *seq, *result, *it, *arg;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000159 Py_ssize_t len; /* guess for result list size */
160 register Py_ssize_t j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000161
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000162 if (!PyArg_UnpackTuple(args, "filter", 2, 2, &func, &seq))
Guido van Rossum12d12c51993-10-26 17:58:25 +0000163 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000164
Tim Peters0e57abf2001-05-02 07:39:38 +0000165 /* Strings and tuples return a result of the same type. */
166 if (PyString_Check(seq))
167 return filterstring(func, seq);
Martin v. Löwis8afd7572003-01-25 22:46:11 +0000168#ifdef Py_USING_UNICODE
169 if (PyUnicode_Check(seq))
170 return filterunicode(func, seq);
171#endif
Tim Peters0e57abf2001-05-02 07:39:38 +0000172 if (PyTuple_Check(seq))
173 return filtertuple(func, seq);
174
Georg Brandle35b6572005-07-19 22:20:20 +0000175 /* Pre-allocate argument list tuple. */
176 arg = PyTuple_New(1);
177 if (arg == NULL)
178 return NULL;
179
Tim Peters0e57abf2001-05-02 07:39:38 +0000180 /* Get iterator. */
181 it = PyObject_GetIter(seq);
182 if (it == NULL)
Georg Brandle35b6572005-07-19 22:20:20 +0000183 goto Fail_arg;
Tim Peters0e57abf2001-05-02 07:39:38 +0000184
185 /* Guess a result list size. */
Armin Rigof5b3e362006-02-11 21:32:43 +0000186 len = _PyObject_LengthHint(seq);
Raymond Hettingerb86269d2004-01-04 11:00:08 +0000187 if (len < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +0000188 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
189 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
190 goto Fail_it;
191 }
Raymond Hettingerb86269d2004-01-04 11:00:08 +0000192 PyErr_Clear();
193 len = 8; /* arbitrary */
Guido van Rossum12d12c51993-10-26 17:58:25 +0000194 }
195
Tim Peters0e57abf2001-05-02 07:39:38 +0000196 /* Get a result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000197 if (PyList_Check(seq) && seq->ob_refcnt == 1) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000198 /* Eww - can modify the list in-place. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000199 Py_INCREF(seq);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000200 result = seq;
201 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000202 else {
Tim Peters0e57abf2001-05-02 07:39:38 +0000203 result = PyList_New(len);
204 if (result == NULL)
205 goto Fail_it;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000206 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000207
Tim Peters0e57abf2001-05-02 07:39:38 +0000208 /* Build the result list. */
Tim Petersf4848da2001-05-05 00:14:56 +0000209 j = 0;
210 for (;;) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000211 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000212 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000213
Tim Peters0e57abf2001-05-02 07:39:38 +0000214 item = PyIter_Next(it);
215 if (item == NULL) {
Tim Petersf4848da2001-05-05 00:14:56 +0000216 if (PyErr_Occurred())
217 goto Fail_result_it;
Tim Peters0e57abf2001-05-02 07:39:38 +0000218 break;
Guido van Rossum2d951851994-08-29 12:52:16 +0000219 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000220
Neil Schemenauer68973552003-08-14 20:37:34 +0000221 if (func == (PyObject *)&PyBool_Type || func == Py_None) {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000222 ok = PyObject_IsTrue(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000223 }
224 else {
Guido van Rossumc7903a12002-08-16 07:04:56 +0000225 PyObject *good;
226 PyTuple_SET_ITEM(arg, 0, item);
227 good = PyObject_Call(func, arg, NULL);
228 PyTuple_SET_ITEM(arg, 0, NULL);
Guido van Rossum58b68731995-01-10 17:40:55 +0000229 if (good == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000230 Py_DECREF(item);
Tim Peters0e57abf2001-05-02 07:39:38 +0000231 goto Fail_result_it;
Guido van Rossum58b68731995-01-10 17:40:55 +0000232 }
Guido van Rossumc7903a12002-08-16 07:04:56 +0000233 ok = PyObject_IsTrue(good);
234 Py_DECREF(good);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000235 }
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000236 if (ok) {
Tim Peters0e57abf2001-05-02 07:39:38 +0000237 if (j < len)
238 PyList_SET_ITEM(result, j, item);
Guido van Rossum2d951851994-08-29 12:52:16 +0000239 else {
Barry Warsawfa77e091999-01-28 18:49:12 +0000240 int status = PyList_Append(result, item);
Barry Warsawfa77e091999-01-28 18:49:12 +0000241 Py_DECREF(item);
242 if (status < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000243 goto Fail_result_it;
Guido van Rossum2d951851994-08-29 12:52:16 +0000244 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000245 ++j;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000246 }
Tim Peters0e57abf2001-05-02 07:39:38 +0000247 else
248 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000249 }
250
Guido van Rossum12d12c51993-10-26 17:58:25 +0000251
Tim Peters0e57abf2001-05-02 07:39:38 +0000252 /* Cut back result list if len is too big. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000253 if (j < len && PyList_SetSlice(result, j, len, NULL) < 0)
Tim Peters0e57abf2001-05-02 07:39:38 +0000254 goto Fail_result_it;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000255
Tim Peters3c6b1482001-05-21 08:07:05 +0000256 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000257 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000258 return result;
259
Tim Peters0e57abf2001-05-02 07:39:38 +0000260Fail_result_it:
Guido van Rossum79f25d91997-04-29 20:08:16 +0000261 Py_DECREF(result);
Tim Peters0e57abf2001-05-02 07:39:38 +0000262Fail_it:
263 Py_DECREF(it);
Guido van Rossumc7903a12002-08-16 07:04:56 +0000264Fail_arg:
265 Py_DECREF(arg);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000266 return NULL;
267}
268
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000269PyDoc_STRVAR(filter_doc,
Tim Petersd50e5442002-03-09 00:06:26 +0000270"filter(function or None, sequence) -> list, tuple, or string\n"
271"\n"
272"Return those items of sequence for which function(item) is true. If\n"
273"function is None, return the items that are true. If sequence is a tuple\n"
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000274"or string, return the same type, else return a list.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000275
Guido van Rossum79f25d91997-04-29 20:08:16 +0000276static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000277builtin_chr(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000278{
279 long x;
280 char s[1];
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000281
Guido van Rossum79f25d91997-04-29 20:08:16 +0000282 if (!PyArg_ParseTuple(args, "l:chr", &x))
Guido van Rossum3f5da241990-12-20 15:06:42 +0000283 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000284 if (x < 0 || x >= 256) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000285 PyErr_SetString(PyExc_ValueError,
286 "chr() arg not in range(256)");
Guido van Rossum3f5da241990-12-20 15:06:42 +0000287 return NULL;
288 }
Guido van Rossum6bf62da1997-04-11 20:37:35 +0000289 s[0] = (char)x;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000290 return PyString_FromStringAndSize(s, 1);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000291}
292
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000293PyDoc_STRVAR(chr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000294"chr(i) -> character\n\
295\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000296Return a string of one character with ordinal i; 0 <= i < 256.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000297
298
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000299#ifdef Py_USING_UNICODE
Guido van Rossum79f25d91997-04-29 20:08:16 +0000300static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000301builtin_unichr(PyObject *self, PyObject *args)
Guido van Rossum09095f32000-03-10 23:00:52 +0000302{
303 long x;
Guido van Rossum09095f32000-03-10 23:00:52 +0000304
305 if (!PyArg_ParseTuple(args, "l:unichr", &x))
306 return NULL;
Fredrik Lundh0dcf67e2001-06-26 20:01:56 +0000307
Marc-André Lemburgcc8764c2002-08-11 12:23:04 +0000308 return PyUnicode_FromOrdinal(x);
Guido van Rossum09095f32000-03-10 23:00:52 +0000309}
310
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000311PyDoc_STRVAR(unichr_doc,
Fred Drake078b24f2000-04-13 02:42:50 +0000312"unichr(i) -> Unicode character\n\
Guido van Rossum09095f32000-03-10 23:00:52 +0000313\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000314Return a Unicode string of one character with ordinal i; 0 <= i <= 0x10ffff.");
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000315#endif
Guido van Rossum09095f32000-03-10 23:00:52 +0000316
317
318static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000319builtin_cmp(PyObject *self, PyObject *args)
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000320{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000321 PyObject *a, *b;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000322 int c;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000323
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000324 if (!PyArg_UnpackTuple(args, "cmp", 2, 2, &a, &b))
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000325 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000326 if (PyObject_Cmp(a, b, &c) < 0)
Guido van Rossumc8b6df91997-05-23 00:06:51 +0000327 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000328 return PyInt_FromLong((long)c);
Guido van Rossuma9e7dc11992-10-18 18:53:57 +0000329}
330
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000331PyDoc_STRVAR(cmp_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000332"cmp(x, y) -> integer\n\
333\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000334Return negative if x<y, zero if x==y, positive if x>y.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000335
Guido van Rossum79f25d91997-04-29 20:08:16 +0000336static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000337builtin_compile(PyObject *self, PyObject *args)
Guido van Rossum5b722181993-03-30 17:46:03 +0000338{
339 char *str;
340 char *filename;
341 char *startstr;
342 int start;
Tim Peters6cd6a822001-08-17 22:11:27 +0000343 int dont_inherit = 0;
344 int supplied_flags = 0;
Tim Peters5ba58662001-07-16 02:29:45 +0000345 PyCompilerFlags cf;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000346 PyObject *result = NULL, *cmd, *tmp = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000347 Py_ssize_t length;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000348
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000349 if (!PyArg_ParseTuple(args, "Oss|ii:compile", &cmd, &filename,
Tim Peters6cd6a822001-08-17 22:11:27 +0000350 &startstr, &supplied_flags, &dont_inherit))
Guido van Rossum5b722181993-03-30 17:46:03 +0000351 return NULL;
Tim Peters6cd6a822001-08-17 22:11:27 +0000352
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000353 cf.cf_flags = supplied_flags;
354
355#ifdef Py_USING_UNICODE
356 if (PyUnicode_Check(cmd)) {
357 tmp = PyUnicode_AsUTF8String(cmd);
358 if (tmp == NULL)
359 return NULL;
360 cmd = tmp;
361 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
362 }
363#endif
Just van Rossumb9b8e9c2003-02-10 09:22:01 +0000364 if (PyObject_AsReadBuffer(cmd, (const void **)&str, &length))
365 return NULL;
Tim Peters2c646c92003-02-10 14:48:29 +0000366 if ((size_t)length != strlen(str)) {
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000367 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000368 "compile() expected string without null bytes");
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000369 goto cleanup;
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000370 }
371
Guido van Rossum5b722181993-03-30 17:46:03 +0000372 if (strcmp(startstr, "exec") == 0)
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000373 start = Py_file_input;
Guido van Rossum5b722181993-03-30 17:46:03 +0000374 else if (strcmp(startstr, "eval") == 0)
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000375 start = Py_eval_input;
Guido van Rossum872537c1995-07-07 22:43:42 +0000376 else if (strcmp(startstr, "single") == 0)
Guido van Rossumb05a5c71997-05-07 17:46:13 +0000377 start = Py_single_input;
Guido van Rossum5b722181993-03-30 17:46:03 +0000378 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000379 PyErr_SetString(PyExc_ValueError,
Fred Drake661ea262000-10-24 19:57:45 +0000380 "compile() arg 3 must be 'exec' or 'eval' or 'single'");
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000381 goto cleanup;
Guido van Rossum5b722181993-03-30 17:46:03 +0000382 }
Tim Peters6cd6a822001-08-17 22:11:27 +0000383
Guido van Rossum4b499dd32003-02-13 22:07:59 +0000384 if (supplied_flags &
Martin v. Löwisbd260da2006-02-26 19:42:26 +0000385 ~(PyCF_MASK | PyCF_MASK_OBSOLETE | PyCF_DONT_IMPLY_DEDENT | PyCF_ONLY_AST))
Guido van Rossum4b499dd32003-02-13 22:07:59 +0000386 {
Tim Peters6cd6a822001-08-17 22:11:27 +0000387 PyErr_SetString(PyExc_ValueError,
388 "compile(): unrecognised flags");
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000389 goto cleanup;
Tim Peters6cd6a822001-08-17 22:11:27 +0000390 }
391 /* XXX Warn if (supplied_flags & PyCF_MASK_OBSOLETE) != 0? */
392
Tim Peters6cd6a822001-08-17 22:11:27 +0000393 if (!dont_inherit) {
394 PyEval_MergeCompilerFlags(&cf);
395 }
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000396 result = Py_CompileStringFlags(str, filename, start, &cf);
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000397cleanup:
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000398 Py_XDECREF(tmp);
399 return result;
Guido van Rossum5b722181993-03-30 17:46:03 +0000400}
401
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000402PyDoc_STRVAR(compile_doc,
Tim Peters6cd6a822001-08-17 22:11:27 +0000403"compile(source, filename, mode[, flags[, dont_inherit]]) -> code object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000404\n\
405Compile the source string (a Python module, statement or expression)\n\
Georg Brandl7cae87c2006-09-06 06:51:57 +0000406into a code object that can be executed by exec() or eval().\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000407The filename will be used for run-time error messages.\n\
408The mode must be 'exec' to compile a module, 'single' to compile a\n\
Tim Peters6cd6a822001-08-17 22:11:27 +0000409single (interactive) statement, or 'eval' to compile an expression.\n\
410The flags argument, if present, controls which future statements influence\n\
411the compilation of the code.\n\
412The dont_inherit argument, if non-zero, stops the compilation inheriting\n\
413the effects of any future statements in effect in the code calling\n\
414compile; if absent or zero these statements do influence the compilation,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000415in addition to any features explicitly specified.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000416
Guido van Rossum79f25d91997-04-29 20:08:16 +0000417static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000418builtin_dir(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000419{
Tim Peters5d2b77c2001-09-03 05:47:38 +0000420 PyObject *arg = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000421
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000422 if (!PyArg_UnpackTuple(args, "dir", 0, 1, &arg))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000423 return NULL;
Tim Peters7eea37e2001-09-04 22:08:56 +0000424 return PyObject_Dir(arg);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000425}
426
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000427PyDoc_STRVAR(dir_doc,
Tim Peters5d2b77c2001-09-03 05:47:38 +0000428"dir([object]) -> list of strings\n"
429"\n"
430"Return an alphabetized list of names comprising (some of) the attributes\n"
431"of the given object, and of attributes reachable from it:\n"
432"\n"
433"No argument: the names in the current scope.\n"
434"Module object: the module attributes.\n"
Tim Peters37a309d2001-09-04 01:20:04 +0000435"Type or class object: its attributes, and recursively the attributes of\n"
436" its bases.\n"
Tim Peters5d2b77c2001-09-03 05:47:38 +0000437"Otherwise: its attributes, its class's attributes, and recursively the\n"
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000438" attributes of its class's base classes.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000439
Guido van Rossum79f25d91997-04-29 20:08:16 +0000440static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000441builtin_divmod(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000442{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000443 PyObject *v, *w;
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000444
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000445 if (!PyArg_UnpackTuple(args, "divmod", 2, 2, &v, &w))
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000446 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +0000447 return PyNumber_Divmod(v, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000448}
449
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000450PyDoc_STRVAR(divmod_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000451"divmod(x, y) -> (div, mod)\n\
452\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000453Return the tuple ((x-x%y)/y, x%y). Invariant: div*y + mod == x.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000454
455
Guido van Rossum79f25d91997-04-29 20:08:16 +0000456static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000457builtin_eval(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000458{
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000459 PyObject *cmd, *result, *tmp = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000460 PyObject *globals = Py_None, *locals = Py_None;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000461 char *str;
Tim Peters9fa96be2001-08-17 23:04:59 +0000462 PyCompilerFlags cf;
Guido van Rossum590baa41993-11-30 13:40:46 +0000463
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000464 if (!PyArg_UnpackTuple(args, "eval", 1, 3, &cmd, &globals, &locals))
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000465 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000466 if (locals != Py_None && !PyMapping_Check(locals)) {
467 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000468 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000469 }
470 if (globals != Py_None && !PyDict_Check(globals)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +0000471 PyErr_SetString(PyExc_TypeError, PyMapping_Check(globals) ?
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000472 "globals must be a real dict; try eval(expr, {}, mapping)"
473 : "globals must be a dict");
Raymond Hettinger513ffe82004-07-06 13:44:41 +0000474 return NULL;
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000475 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000476 if (globals == Py_None) {
477 globals = PyEval_GetGlobals();
478 if (locals == Py_None)
479 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000480 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000481 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000482 locals = globals;
Tim Peters9fa96be2001-08-17 23:04:59 +0000483
Georg Brandl77c85e62005-09-15 10:46:13 +0000484 if (globals == NULL || locals == NULL) {
485 PyErr_SetString(PyExc_TypeError,
486 "eval must be given globals and locals "
487 "when called without a frame");
488 return NULL;
489 }
490
Guido van Rossum79f25d91997-04-29 20:08:16 +0000491 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
492 if (PyDict_SetItemString(globals, "__builtins__",
493 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000494 return NULL;
495 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000496
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000497 if (PyCode_Check(cmd)) {
Jeremy Hylton733c8932001-12-13 19:51:56 +0000498 if (PyCode_GetNumFree((PyCodeObject *)cmd) > 0) {
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000499 PyErr_SetString(PyExc_TypeError,
500 "code object passed to eval() may not contain free variables");
501 return NULL;
502 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000503 return PyEval_EvalCode((PyCodeObject *) cmd, globals, locals);
Jeremy Hylton15c1c4f2001-07-30 21:50:55 +0000504 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000505
Marc-André Lemburgd1ba4432000-09-19 21:04:18 +0000506 if (!PyString_Check(cmd) &&
507 !PyUnicode_Check(cmd)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000508 PyErr_SetString(PyExc_TypeError,
Fred Drake661ea262000-10-24 19:57:45 +0000509 "eval() arg 1 must be a string or code object");
Guido van Rossum94390a41992-08-14 15:14:30 +0000510 return NULL;
511 }
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000512 cf.cf_flags = 0;
513
514#ifdef Py_USING_UNICODE
515 if (PyUnicode_Check(cmd)) {
516 tmp = PyUnicode_AsUTF8String(cmd);
517 if (tmp == NULL)
518 return NULL;
519 cmd = tmp;
520 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
521 }
522#endif
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000523 if (PyString_AsStringAndSize(cmd, &str, NULL)) {
524 Py_XDECREF(tmp);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000525 return NULL;
Neal Norwitz3a9a3e72005-11-27 20:38:31 +0000526 }
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000527 while (*str == ' ' || *str == '\t')
528 str++;
Tim Peters9fa96be2001-08-17 23:04:59 +0000529
Tim Peters9fa96be2001-08-17 23:04:59 +0000530 (void)PyEval_MergeCompilerFlags(&cf);
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000531 result = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
532 Py_XDECREF(tmp);
533 return result;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000534}
535
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000536PyDoc_STRVAR(eval_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000537"eval(source[, globals[, locals]]) -> value\n\
538\n\
539Evaluate the source in the context of globals and locals.\n\
540The source may be a string representing a Python expression\n\
541or a code object as returned by compile().\n\
Thomas Wouters89f507f2006-12-13 04:49:30 +0000542The globals must be a dictionary and locals can be any mapping,\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000543defaulting to the current globals and locals.\n\
544If only globals is given, locals defaults to it.\n");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000545
Georg Brandl7cae87c2006-09-06 06:51:57 +0000546static PyObject *
547builtin_exec(PyObject *self, PyObject *args)
548{
549 PyObject *v;
550 PyObject *prog, *globals = Py_None, *locals = Py_None;
551 int plain = 0;
552
553 if (!PyArg_ParseTuple(args, "O|OO:exec", &prog, &globals, &locals))
554 return NULL;
555
556 if (globals == Py_None) {
557 globals = PyEval_GetGlobals();
558 if (locals == Py_None) {
559 locals = PyEval_GetLocals();
560 plain = 1;
561 }
562 if (!globals || !locals) {
563 PyErr_SetString(PyExc_SystemError,
564 "globals and locals cannot be NULL");
565 return NULL;
566 }
567 }
568 else if (locals == Py_None)
569 locals = globals;
570 if (!PyString_Check(prog) &&
571 !PyUnicode_Check(prog) &&
572 !PyCode_Check(prog) &&
573 !PyFile_Check(prog)) {
574 PyErr_Format(PyExc_TypeError,
575 "exec() arg 1 must be a string, file, or code "
576 "object, not %.100s", prog->ob_type->tp_name);
577 return NULL;
578 }
579 if (!PyDict_Check(globals)) {
580 PyErr_Format(PyExc_TypeError, "exec() arg 2 must be a dict, not %.100s",
581 globals->ob_type->tp_name);
582 return NULL;
583 }
584 if (!PyMapping_Check(locals)) {
585 PyErr_Format(PyExc_TypeError,
586 "arg 3 must be a mapping or None, not %.100s",
587 locals->ob_type->tp_name);
588 return NULL;
589 }
590 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
591 if (PyDict_SetItemString(globals, "__builtins__",
592 PyEval_GetBuiltins()) != 0)
593 return NULL;
594 }
595
596 if (PyCode_Check(prog)) {
597 if (PyCode_GetNumFree((PyCodeObject *)prog) > 0) {
598 PyErr_SetString(PyExc_TypeError,
599 "code object passed to exec() may not "
600 "contain free variables");
601 return NULL;
602 }
603 v = PyEval_EvalCode((PyCodeObject *) prog, globals, locals);
604 }
605 else if (PyFile_Check(prog)) {
606 FILE *fp = PyFile_AsFile(prog);
607 char *name = PyString_AsString(PyFile_Name(prog));
608 PyCompilerFlags cf;
609 cf.cf_flags = 0;
610 if (PyEval_MergeCompilerFlags(&cf))
611 v = PyRun_FileFlags(fp, name, Py_file_input, globals,
612 locals, &cf);
613 else
614 v = PyRun_File(fp, name, Py_file_input, globals,
615 locals);
616 }
617 else {
618 PyObject *tmp = NULL;
619 char *str;
620 PyCompilerFlags cf;
621 cf.cf_flags = 0;
622#ifdef Py_USING_UNICODE
623 if (PyUnicode_Check(prog)) {
624 tmp = PyUnicode_AsUTF8String(prog);
625 if (tmp == NULL)
626 return NULL;
627 prog = tmp;
628 cf.cf_flags |= PyCF_SOURCE_IS_UTF8;
629 }
630#endif
631 if (PyString_AsStringAndSize(prog, &str, NULL))
632 return NULL;
633 if (PyEval_MergeCompilerFlags(&cf))
634 v = PyRun_StringFlags(str, Py_file_input, globals,
635 locals, &cf);
636 else
637 v = PyRun_String(str, Py_file_input, globals, locals);
638 Py_XDECREF(tmp);
639 }
640 if (v == NULL)
641 return NULL;
642 Py_DECREF(v);
643 Py_RETURN_NONE;
644}
645
646PyDoc_STRVAR(exec_doc,
647"exec(object[, globals[, locals]])\n\
648\n\
649Read and execute code from a object, which can be a string, a code\n\
650object or a file object.\n\
651The globals and locals are dictionaries, defaulting to the current\n\
652globals and locals. If only globals is given, locals defaults to it.");
653
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000654
Guido van Rossum79f25d91997-04-29 20:08:16 +0000655static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000656builtin_execfile(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000657{
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000658 char *filename;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000659 PyObject *globals = Py_None, *locals = Py_None;
660 PyObject *res;
Guido van Rossumb3a639e2001-09-05 13:37:47 +0000661 FILE* fp = NULL;
Tim Peters5ba58662001-07-16 02:29:45 +0000662 PyCompilerFlags cf;
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000663 int exists;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000664
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000665 if (!PyArg_ParseTuple(args, "s|O!O:execfile",
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000666 &filename,
Guido van Rossum79f25d91997-04-29 20:08:16 +0000667 &PyDict_Type, &globals,
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000668 &locals))
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000669 return NULL;
Raymond Hettinger66bd2332004-08-02 08:30:07 +0000670 if (locals != Py_None && !PyMapping_Check(locals)) {
671 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
672 return NULL;
673 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000674 if (globals == Py_None) {
675 globals = PyEval_GetGlobals();
676 if (locals == Py_None)
677 locals = PyEval_GetLocals();
Guido van Rossum6135a871995-01-09 17:53:26 +0000678 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000679 else if (locals == Py_None)
Guido van Rossum6135a871995-01-09 17:53:26 +0000680 locals = globals;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000681 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
682 if (PyDict_SetItemString(globals, "__builtins__",
683 PyEval_GetBuiltins()) != 0)
Guido van Rossum6135a871995-01-09 17:53:26 +0000684 return NULL;
685 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000686
687 exists = 0;
688 /* Test for existence or directory. */
Martin v. Löwis3484a182002-03-09 12:07:51 +0000689#if defined(PLAN9)
690 {
691 Dir *d;
692
693 if ((d = dirstat(filename))!=nil) {
694 if(d->mode & DMDIR)
695 werrstr("is a directory");
696 else
697 exists = 1;
698 free(d);
699 }
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000700 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000701#elif defined(RISCOS)
Guido van Rossume2ae77b2001-10-24 20:42:55 +0000702 if (object_exists(filename)) {
703 if (isdir(filename))
704 errno = EISDIR;
705 else
706 exists = 1;
707 }
Martin v. Löwis3484a182002-03-09 12:07:51 +0000708#else /* standard Posix */
709 {
710 struct stat s;
711 if (stat(filename, &s) == 0) {
712 if (S_ISDIR(s.st_mode))
Andrew MacIntyreda4d6cb2004-03-29 11:53:38 +0000713# if defined(PYOS_OS2) && defined(PYCC_VACPP)
Martin v. Löwis3484a182002-03-09 12:07:51 +0000714 errno = EOS2ERR;
715# else
716 errno = EISDIR;
717# endif
718 else
719 exists = 1;
720 }
721 }
722#endif
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000723
724 if (exists) {
725 Py_BEGIN_ALLOW_THREADS
Jack Jansen7b8c7542002-04-14 20:12:41 +0000726 fp = fopen(filename, "r" PY_STDIOTEXTMODE);
Martin v. Löwis6b3a2c42001-08-08 05:30:36 +0000727 Py_END_ALLOW_THREADS
728
729 if (fp == NULL) {
730 exists = 0;
731 }
732 }
733
734 if (!exists) {
Peter Schneider-Kamp4c013422002-08-27 16:58:00 +0000735 PyErr_SetFromErrnoWithFilename(PyExc_IOError, filename);
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000736 return NULL;
737 }
Tim Peters5ba58662001-07-16 02:29:45 +0000738 cf.cf_flags = 0;
739 if (PyEval_MergeCompilerFlags(&cf))
Tim Peters748b8bb2001-04-28 08:20:22 +0000740 res = PyRun_FileExFlags(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000741 locals, 1, &cf);
Tim Peters5ba58662001-07-16 02:29:45 +0000742 else
Tim Peters748b8bb2001-04-28 08:20:22 +0000743 res = PyRun_FileEx(fp, filename, Py_file_input, globals,
Jeremy Hyltonbc320242001-03-22 02:47:58 +0000744 locals, 1);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000745 return res;
Guido van Rossum0f61f8a1992-02-25 18:55:05 +0000746}
747
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000748PyDoc_STRVAR(execfile_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000749"execfile(filename[, globals[, locals]])\n\
750\n\
751Read and execute a Python script from a file.\n\
752The globals and locals are dictionaries, defaulting to the current\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000753globals and locals. If only globals is given, locals defaults to it.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000754
755
Guido van Rossum79f25d91997-04-29 20:08:16 +0000756static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000757builtin_getattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000758{
Guido van Rossum950ff291998-06-29 13:38:57 +0000759 PyObject *v, *result, *dflt = NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +0000760 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000761
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000762 if (!PyArg_UnpackTuple(args, "getattr", 2, 3, &v, &name, &dflt))
Guido van Rossum33894be1992-01-27 16:53:09 +0000763 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000764#ifdef Py_USING_UNICODE
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000765 if (PyUnicode_Check(name)) {
766 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
767 if (name == NULL)
768 return NULL;
769 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000770#endif
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000771
772 if (!PyString_Check(name)) {
773 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000774 "getattr(): attribute name must be string");
Jeremy Hylton0eb11152001-07-30 22:39:31 +0000775 return NULL;
776 }
Guido van Rossum950ff291998-06-29 13:38:57 +0000777 result = PyObject_GetAttr(v, name);
Guido van Rossumd8923572001-10-16 21:31:32 +0000778 if (result == NULL && dflt != NULL &&
779 PyErr_ExceptionMatches(PyExc_AttributeError))
780 {
Guido van Rossum950ff291998-06-29 13:38:57 +0000781 PyErr_Clear();
782 Py_INCREF(dflt);
783 result = dflt;
784 }
785 return result;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000786}
787
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000788PyDoc_STRVAR(getattr_doc,
Guido van Rossum950ff291998-06-29 13:38:57 +0000789"getattr(object, name[, default]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000790\n\
Guido van Rossum950ff291998-06-29 13:38:57 +0000791Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
792When a default argument is given, it is returned when the attribute doesn't\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000793exist; without it, an exception is raised in that case.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000794
795
Guido van Rossum79f25d91997-04-29 20:08:16 +0000796static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000797builtin_globals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +0000798{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000799 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000800
Guido van Rossum79f25d91997-04-29 20:08:16 +0000801 d = PyEval_GetGlobals();
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000802 Py_XINCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +0000803 return d;
804}
805
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000806PyDoc_STRVAR(globals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000807"globals() -> dictionary\n\
808\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000809Return the dictionary containing the current scope's global variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000810
811
Guido van Rossum79f25d91997-04-29 20:08:16 +0000812static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000813builtin_hasattr(PyObject *self, PyObject *args)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000814{
Guido van Rossum79f25d91997-04-29 20:08:16 +0000815 PyObject *v;
816 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000817
Raymond Hettingerea3fdf42002-12-29 16:33:45 +0000818 if (!PyArg_UnpackTuple(args, "hasattr", 2, 2, &v, &name))
Guido van Rossum9bfef441993-03-29 10:43:31 +0000819 return NULL;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000820#ifdef Py_USING_UNICODE
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000821 if (PyUnicode_Check(name)) {
822 name = _PyUnicode_AsDefaultEncodedString(name, NULL);
823 if (name == NULL)
824 return NULL;
825 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000826#endif
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000827
828 if (!PyString_Check(name)) {
829 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +0000830 "hasattr(): attribute name must be string");
Jeremy Hylton302b54a2001-07-30 22:45:19 +0000831 return NULL;
832 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000833 v = PyObject_GetAttr(v, name);
Guido van Rossum9bfef441993-03-29 10:43:31 +0000834 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000835 PyErr_Clear();
Guido van Rossum09df08a1998-05-22 00:51:39 +0000836 Py_INCREF(Py_False);
837 return Py_False;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000838 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000839 Py_DECREF(v);
Guido van Rossum09df08a1998-05-22 00:51:39 +0000840 Py_INCREF(Py_True);
841 return Py_True;
Guido van Rossum33894be1992-01-27 16:53:09 +0000842}
843
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000844PyDoc_STRVAR(hasattr_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000845"hasattr(object, name) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000846\n\
847Return whether the object has an attribute with the given name.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000848(This is done by calling getattr(object, name) and catching exceptions.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000849
850
Guido van Rossum79f25d91997-04-29 20:08:16 +0000851static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000852builtin_id(PyObject *self, PyObject *v)
Guido van Rossum5b722181993-03-30 17:46:03 +0000853{
Guido van Rossum106f2da2000-06-28 21:12:25 +0000854 return PyLong_FromVoidPtr(v);
Guido van Rossum5b722181993-03-30 17:46:03 +0000855}
856
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000857PyDoc_STRVAR(id_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000858"id(object) -> integer\n\
859\n\
860Return the identity of an object. This is guaranteed to be unique among\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000861simultaneously existing objects. (Hint: it's the object's memory address.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000862
863
Guido van Rossum79f25d91997-04-29 20:08:16 +0000864static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000865builtin_map(PyObject *self, PyObject *args)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000866{
867 typedef struct {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000868 PyObject *it; /* the iterator object */
869 int saw_StopIteration; /* bool: did the iterator end? */
Guido van Rossum12d12c51993-10-26 17:58:25 +0000870 } sequence;
871
Guido van Rossum79f25d91997-04-29 20:08:16 +0000872 PyObject *func, *result;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000873 sequence *seqs = NULL, *sqp;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000874 Py_ssize_t n, len;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000875 register int i, j;
876
Guido van Rossum79f25d91997-04-29 20:08:16 +0000877 n = PyTuple_Size(args);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000878 if (n < 2) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000879 PyErr_SetString(PyExc_TypeError,
880 "map() requires at least two args");
Guido van Rossum12d12c51993-10-26 17:58:25 +0000881 return NULL;
882 }
883
Guido van Rossum79f25d91997-04-29 20:08:16 +0000884 func = PyTuple_GetItem(args, 0);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000885 n--;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000886
Guido van Rossumfa4ac711998-07-10 17:37:30 +0000887 if (func == Py_None && n == 1) {
888 /* map(None, S) is the same as list(S). */
889 return PySequence_List(PyTuple_GetItem(args, 1));
890 }
891
Tim Peters4e9afdc2001-05-03 23:54:49 +0000892 /* Get space for sequence descriptors. Must NULL out the iterator
893 * pointers so that jumping to Fail_2 later doesn't see trash.
894 */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000895 if ((seqs = PyMem_NEW(sequence, n)) == NULL) {
896 PyErr_NoMemory();
Tim Peters4e9afdc2001-05-03 23:54:49 +0000897 return NULL;
898 }
899 for (i = 0; i < n; ++i) {
900 seqs[i].it = (PyObject*)NULL;
901 seqs[i].saw_StopIteration = 0;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000902 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000903
Tim Peters4e9afdc2001-05-03 23:54:49 +0000904 /* Do a first pass to obtain iterators for the arguments, and set len
905 * to the largest of their lengths.
Tim Peters748b8bb2001-04-28 08:20:22 +0000906 */
Tim Peters4e9afdc2001-05-03 23:54:49 +0000907 len = 0;
908 for (i = 0, sqp = seqs; i < n; ++i, ++sqp) {
909 PyObject *curseq;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000910 Py_ssize_t curlen;
Guido van Rossumad991772001-01-12 16:03:05 +0000911
Tim Peters4e9afdc2001-05-03 23:54:49 +0000912 /* Get iterator. */
913 curseq = PyTuple_GetItem(args, i+1);
914 sqp->it = PyObject_GetIter(curseq);
915 if (sqp->it == NULL) {
Guido van Rossum12d12c51993-10-26 17:58:25 +0000916 static char errmsg[] =
Tim Peters4e9afdc2001-05-03 23:54:49 +0000917 "argument %d to map() must support iteration";
Guido van Rossum15e33a41997-04-30 19:00:27 +0000918 char errbuf[sizeof(errmsg) + 25];
Jeremy Hylton518ab1c2001-11-28 20:42:20 +0000919 PyOS_snprintf(errbuf, sizeof(errbuf), errmsg, i+2);
Guido van Rossum79f25d91997-04-29 20:08:16 +0000920 PyErr_SetString(PyExc_TypeError, errbuf);
Guido van Rossum12d12c51993-10-26 17:58:25 +0000921 goto Fail_2;
922 }
923
Tim Peters4e9afdc2001-05-03 23:54:49 +0000924 /* Update len. */
Armin Rigof5b3e362006-02-11 21:32:43 +0000925 curlen = _PyObject_LengthHint(curseq);
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000926 if (curlen < 0) {
Raymond Hettingera710b332005-08-21 11:03:59 +0000927 if (!PyErr_ExceptionMatches(PyExc_TypeError) &&
928 !PyErr_ExceptionMatches(PyExc_AttributeError)) {
929 goto Fail_2;
930 }
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000931 PyErr_Clear();
Tim Peters4e9afdc2001-05-03 23:54:49 +0000932 curlen = 8; /* arbitrary */
Raymond Hettinger77f3c872004-01-04 08:54:44 +0000933 }
934 if (curlen > len)
935 len = curlen;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000936 }
937
Tim Peters4e9afdc2001-05-03 23:54:49 +0000938 /* Get space for the result list. */
Guido van Rossum79f25d91997-04-29 20:08:16 +0000939 if ((result = (PyObject *) PyList_New(len)) == NULL)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000940 goto Fail_2;
941
Tim Peters4e9afdc2001-05-03 23:54:49 +0000942 /* Iterate over the sequences until all have stopped. */
Guido van Rossum2d951851994-08-29 12:52:16 +0000943 for (i = 0; ; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000944 PyObject *alist, *item=NULL, *value;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000945 int numactive = 0;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000946
Guido van Rossum79f25d91997-04-29 20:08:16 +0000947 if (func == Py_None && n == 1)
Guido van Rossum32120311995-07-10 13:52:21 +0000948 alist = NULL;
Tim Peters4e9afdc2001-05-03 23:54:49 +0000949 else if ((alist = PyTuple_New(n)) == NULL)
950 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000951
952 for (j = 0, sqp = seqs; j < n; ++j, ++sqp) {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000953 if (sqp->saw_StopIteration) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000954 Py_INCREF(Py_None);
955 item = Py_None;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000956 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000957 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000958 item = PyIter_Next(sqp->it);
959 if (item)
960 ++numactive;
961 else {
Tim Peters4e9afdc2001-05-03 23:54:49 +0000962 if (PyErr_Occurred()) {
Tim Petersf4848da2001-05-05 00:14:56 +0000963 Py_XDECREF(alist);
964 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000965 }
Tim Peters4e9afdc2001-05-03 23:54:49 +0000966 Py_INCREF(Py_None);
967 item = Py_None;
968 sqp->saw_StopIteration = 1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000969 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000970 }
Tim Peters4e9afdc2001-05-03 23:54:49 +0000971 if (alist)
972 PyTuple_SET_ITEM(alist, j, item);
973 else
Guido van Rossum2d951851994-08-29 12:52:16 +0000974 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000975 }
976
Guido van Rossum32120311995-07-10 13:52:21 +0000977 if (!alist)
978 alist = item;
Guido van Rossum2d951851994-08-29 12:52:16 +0000979
Tim Peters4e9afdc2001-05-03 23:54:49 +0000980 if (numactive == 0) {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000981 Py_DECREF(alist);
Guido van Rossum2d951851994-08-29 12:52:16 +0000982 break;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000983 }
Guido van Rossum2d951851994-08-29 12:52:16 +0000984
Guido van Rossum79f25d91997-04-29 20:08:16 +0000985 if (func == Py_None)
Guido van Rossum32120311995-07-10 13:52:21 +0000986 value = alist;
Guido van Rossum12d12c51993-10-26 17:58:25 +0000987 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000988 value = PyEval_CallObject(func, alist);
989 Py_DECREF(alist);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +0000990 if (value == NULL)
991 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000992 }
993 if (i >= len) {
Barry Warsawfa77e091999-01-28 18:49:12 +0000994 int status = PyList_Append(result, value);
Barry Warsaw21332871999-01-28 04:21:35 +0000995 Py_DECREF(value);
Barry Warsawfa77e091999-01-28 18:49:12 +0000996 if (status < 0)
997 goto Fail_1;
Guido van Rossum2d951851994-08-29 12:52:16 +0000998 }
Tim Peters4e9afdc2001-05-03 23:54:49 +0000999 else if (PyList_SetItem(result, i, value) < 0)
1000 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001001 }
1002
Guido van Rossumfa4ac711998-07-10 17:37:30 +00001003 if (i < len && PyList_SetSlice(result, i, len, NULL) < 0)
1004 goto Fail_1;
1005
Tim Peters4e9afdc2001-05-03 23:54:49 +00001006 goto Succeed;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001007
Guido van Rossum12d12c51993-10-26 17:58:25 +00001008Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00001009 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00001010Fail_2:
Tim Peters4e9afdc2001-05-03 23:54:49 +00001011 result = NULL;
1012Succeed:
1013 assert(seqs);
1014 for (i = 0; i < n; ++i)
1015 Py_XDECREF(seqs[i].it);
1016 PyMem_DEL(seqs);
1017 return result;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001018}
1019
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001020PyDoc_STRVAR(map_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001021"map(function, sequence[, sequence, ...]) -> list\n\
1022\n\
1023Return a list of the results of applying the function to the items of\n\
1024the argument sequence(s). If more than one sequence is given, the\n\
1025function is called with an argument list consisting of the corresponding\n\
1026item of each sequence, substituting None for missing values when not all\n\
1027sequences have the same length. If the function is None, return a list of\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001028the items of the sequence (or a list of tuples if more than one sequence).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001029
1030
Guido van Rossum79f25d91997-04-29 20:08:16 +00001031static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001032builtin_setattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +00001033{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001034 PyObject *v;
1035 PyObject *name;
1036 PyObject *value;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001037
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001038 if (!PyArg_UnpackTuple(args, "setattr", 3, 3, &v, &name, &value))
Guido van Rossum33894be1992-01-27 16:53:09 +00001039 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001040 if (PyObject_SetAttr(v, name, value) != 0)
Guido van Rossum33894be1992-01-27 16:53:09 +00001041 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001042 Py_INCREF(Py_None);
1043 return Py_None;
Guido van Rossum33894be1992-01-27 16:53:09 +00001044}
1045
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001046PyDoc_STRVAR(setattr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001047"setattr(object, name, value)\n\
1048\n\
1049Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001050``x.y = v''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001051
1052
Guido van Rossum79f25d91997-04-29 20:08:16 +00001053static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001054builtin_delattr(PyObject *self, PyObject *args)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001055{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001056 PyObject *v;
1057 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001058
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001059 if (!PyArg_UnpackTuple(args, "delattr", 2, 2, &v, &name))
Guido van Rossum14144fc1994-08-29 12:53:40 +00001060 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001061 if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001062 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001063 Py_INCREF(Py_None);
1064 return Py_None;
Guido van Rossum14144fc1994-08-29 12:53:40 +00001065}
1066
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001067PyDoc_STRVAR(delattr_doc,
Guido van Rossumdf12a591998-11-23 22:13:04 +00001068"delattr(object, name)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001069\n\
1070Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001071``del x.y''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001072
1073
Guido van Rossum79f25d91997-04-29 20:08:16 +00001074static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001075builtin_hash(PyObject *self, PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00001076{
Guido van Rossum9bfef441993-03-29 10:43:31 +00001077 long x;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001078
Guido van Rossum79f25d91997-04-29 20:08:16 +00001079 x = PyObject_Hash(v);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001080 if (x == -1)
1081 return NULL;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001082 return PyInt_FromLong(x);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001083}
1084
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001085PyDoc_STRVAR(hash_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001086"hash(object) -> integer\n\
1087\n\
1088Return a hash value for the object. Two objects with the same value have\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001089the same hash value. The reverse is not necessarily true, but likely.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001090
1091
Guido van Rossum79f25d91997-04-29 20:08:16 +00001092static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001093builtin_hex(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001094{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001095 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001096 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001097
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001098 if ((nb = v->ob_type->tp_as_number) == NULL ||
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001099 nb->nb_hex == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001100 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001101 "hex() argument can't be converted to hex");
1102 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001103 }
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001104 res = (*nb->nb_hex)(v);
1105 if (res && !PyString_Check(res)) {
1106 PyErr_Format(PyExc_TypeError,
1107 "__hex__ returned non-string (type %.200s)",
1108 res->ob_type->tp_name);
1109 Py_DECREF(res);
1110 return NULL;
1111 }
1112 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001113}
1114
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001115PyDoc_STRVAR(hex_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001116"hex(number) -> string\n\
1117\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001118Return the hexadecimal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001119
1120
Guido van Rossum79f25d91997-04-29 20:08:16 +00001121static PyObject *
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001122builtin_iter(PyObject *self, PyObject *args)
1123{
1124 PyObject *v, *w = NULL;
1125
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001126 if (!PyArg_UnpackTuple(args, "iter", 1, 2, &v, &w))
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001127 return NULL;
1128 if (w == NULL)
1129 return PyObject_GetIter(v);
1130 if (!PyCallable_Check(v)) {
1131 PyErr_SetString(PyExc_TypeError,
1132 "iter(v, w): v must be callable");
1133 return NULL;
1134 }
1135 return PyCallIter_New(v, w);
1136}
1137
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001138PyDoc_STRVAR(iter_doc,
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001139"iter(collection) -> iterator\n\
1140iter(callable, sentinel) -> iterator\n\
1141\n\
1142Get an iterator from an object. In the first form, the argument must\n\
1143supply its own iterator, or be a sequence.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001144In the second form, the callable is called until it returns the sentinel.");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001145
1146
1147static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001148builtin_len(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001149{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001150 Py_ssize_t res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001151
Jeremy Hylton03657cf2000-07-12 13:05:33 +00001152 res = PyObject_Size(v);
Guido van Rossum8ea9f4d1998-06-29 22:26:50 +00001153 if (res < 0 && PyErr_Occurred())
1154 return NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001155 return PyInt_FromSsize_t(res);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001156}
1157
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001158PyDoc_STRVAR(len_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001159"len(object) -> integer\n\
1160\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001161Return the number of items of a sequence or mapping.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001162
1163
Guido van Rossum79f25d91997-04-29 20:08:16 +00001164static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001165builtin_locals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +00001166{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001167 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001168
Guido van Rossum79f25d91997-04-29 20:08:16 +00001169 d = PyEval_GetLocals();
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00001170 Py_XINCREF(d);
Guido van Rossum872537c1995-07-07 22:43:42 +00001171 return d;
1172}
1173
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001174PyDoc_STRVAR(locals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001175"locals() -> dictionary\n\
1176\n\
Raymond Hettinger69bf8f32003-01-04 02:16:22 +00001177Update and return a dictionary containing the current scope's local variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001178
1179
Guido van Rossum79f25d91997-04-29 20:08:16 +00001180static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001181min_max(PyObject *args, PyObject *kwds, int op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001182{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001183 PyObject *v, *it, *item, *val, *maxitem, *maxval, *keyfunc=NULL;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001184 const char *name = op == Py_LT ? "min" : "max";
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001185
Guido van Rossum79f25d91997-04-29 20:08:16 +00001186 if (PyTuple_Size(args) > 1)
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001187 v = args;
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001188 else if (!PyArg_UnpackTuple(args, (char *)name, 1, 1, &v))
Guido van Rossum3f5da241990-12-20 15:06:42 +00001189 return NULL;
Tim Peters67d687a2002-04-29 21:27:32 +00001190
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001191 if (kwds != NULL && PyDict_Check(kwds) && PyDict_Size(kwds)) {
1192 keyfunc = PyDict_GetItemString(kwds, "key");
1193 if (PyDict_Size(kwds)!=1 || keyfunc == NULL) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001194 PyErr_Format(PyExc_TypeError,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001195 "%s() got an unexpected keyword argument", name);
1196 return NULL;
1197 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001198 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001199
Tim Petersc3074532001-05-03 07:00:32 +00001200 it = PyObject_GetIter(v);
1201 if (it == NULL)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001202 return NULL;
Tim Petersc3074532001-05-03 07:00:32 +00001203
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001204 maxitem = NULL; /* the result */
1205 maxval = NULL; /* the value associated with the result */
Brett Cannon9e635cf2004-12-07 00:25:35 +00001206 while (( item = PyIter_Next(it) )) {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001207 /* get the value from the key function */
1208 if (keyfunc != NULL) {
1209 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1210 if (val == NULL)
1211 goto Fail_it_item;
1212 }
1213 /* no key function; the value is the item */
1214 else {
1215 val = item;
1216 Py_INCREF(val);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001217 }
Tim Petersc3074532001-05-03 07:00:32 +00001218
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001219 /* maximum value and item are unset; set them */
1220 if (maxval == NULL) {
1221 maxitem = item;
1222 maxval = val;
1223 }
1224 /* maximum value and item are set; update them as necessary */
Guido van Rossum2d951851994-08-29 12:52:16 +00001225 else {
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001226 int cmp = PyObject_RichCompareBool(val, maxval, op);
1227 if (cmp < 0)
1228 goto Fail_it_item_and_val;
1229 else if (cmp > 0) {
1230 Py_DECREF(maxval);
1231 Py_DECREF(maxitem);
1232 maxval = val;
1233 maxitem = item;
Guido van Rossum53451b32001-01-17 15:47:24 +00001234 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001235 else {
1236 Py_DECREF(item);
1237 Py_DECREF(val);
Guido van Rossumc8b6df91997-05-23 00:06:51 +00001238 }
Guido van Rossum2d951851994-08-29 12:52:16 +00001239 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001240 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001241 if (PyErr_Occurred())
1242 goto Fail_it;
1243 if (maxval == NULL) {
Martin v. Löwisfd39ad42004-08-12 14:42:37 +00001244 PyErr_Format(PyExc_ValueError,
1245 "%s() arg is an empty sequence", name);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001246 assert(maxitem == NULL);
1247 }
1248 else
1249 Py_DECREF(maxval);
Tim Petersc3074532001-05-03 07:00:32 +00001250 Py_DECREF(it);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001251 return maxitem;
1252
1253Fail_it_item_and_val:
1254 Py_DECREF(val);
1255Fail_it_item:
1256 Py_DECREF(item);
1257Fail_it:
1258 Py_XDECREF(maxval);
1259 Py_XDECREF(maxitem);
1260 Py_DECREF(it);
1261 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001262}
1263
Guido van Rossum79f25d91997-04-29 20:08:16 +00001264static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001265builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001266{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001267 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001268}
1269
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001270PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001271"min(iterable[, key=func]) -> value\n\
1272min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001273\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001274With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001275With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001276
1277
Guido van Rossum79f25d91997-04-29 20:08:16 +00001278static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001279builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001280{
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001281 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001282}
1283
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001284PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001285"max(iterable[, key=func]) -> value\n\
1286max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001287\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001288With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001289With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001290
1291
Guido van Rossum79f25d91997-04-29 20:08:16 +00001292static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001293builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001294{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001295 PyNumberMethods *nb;
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001296 PyObject *res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001297
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001298 if (v == NULL || (nb = v->ob_type->tp_as_number) == NULL ||
1299 nb->nb_oct == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001300 PyErr_SetString(PyExc_TypeError,
Guido van Rossum1899c2e1992-09-12 11:09:23 +00001301 "oct() argument can't be converted to oct");
1302 return NULL;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001303 }
Neil Schemenauer3a313e32004-07-19 16:29:17 +00001304 res = (*nb->nb_oct)(v);
1305 if (res && !PyString_Check(res)) {
1306 PyErr_Format(PyExc_TypeError,
1307 "__oct__ returned non-string (type %.200s)",
1308 res->ob_type->tp_name);
1309 Py_DECREF(res);
1310 return NULL;
1311 }
1312 return res;
Guido van Rossum006bcd41991-10-24 14:54:44 +00001313}
1314
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001315PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001316"oct(number) -> string\n\
1317\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001318Return the octal representation of an integer or long integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001319
1320
Guido van Rossum79f25d91997-04-29 20:08:16 +00001321static PyObject *
Thomas Wouters477c8d52006-05-27 19:21:47 +00001322builtin_open(PyObject *self, PyObject *args, PyObject *kwds)
1323{
1324 return PyObject_Call((PyObject*)&PyFile_Type, args, kwds);
1325}
1326
1327PyDoc_STRVAR(open_doc,
1328"open(name[, mode[, buffering]]) -> file object\n\
1329\n\
1330Open a file using the file() type, returns a file object.");
1331
1332
1333static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001334builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001335{
Guido van Rossum09095f32000-03-10 23:00:52 +00001336 long ord;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001337 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001338
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001339 if (PyString_Check(obj)) {
1340 size = PyString_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001341 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001342 ord = (long)((unsigned char)*PyString_AS_STRING(obj));
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001343 return PyInt_FromLong(ord);
1344 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001345#ifdef Py_USING_UNICODE
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001346 } else if (PyUnicode_Check(obj)) {
1347 size = PyUnicode_GET_SIZE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001348 if (size == 1) {
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001349 ord = (long)*PyUnicode_AS_UNICODE(obj);
Andrew M. Kuchling34c20cf2000-12-20 14:36:56 +00001350 return PyInt_FromLong(ord);
1351 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001352#endif
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001353 } else {
1354 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001355 "ord() expected string of length 1, but " \
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001356 "%.200s found", obj->ob_type->tp_name);
Guido van Rossum09095f32000-03-10 23:00:52 +00001357 return NULL;
1358 }
1359
Guido van Rossumad991772001-01-12 16:03:05 +00001360 PyErr_Format(PyExc_TypeError,
Andrew M. Kuchlingf07aad12000-12-23 14:11:28 +00001361 "ord() expected a character, "
Martin v. Löwisd96ee902006-02-16 14:37:16 +00001362 "but string of length %zd found",
Jeremy Hylton394b54d2000-04-12 21:19:47 +00001363 size);
1364 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001365}
1366
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001367PyDoc_STRVAR(ord_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001368"ord(c) -> integer\n\
1369\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001370Return the integer ordinal of a one-character string.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001371
1372
Guido van Rossum79f25d91997-04-29 20:08:16 +00001373static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001374builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001375{
Guido van Rossum09df08a1998-05-22 00:51:39 +00001376 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001377
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001378 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001379 return NULL;
Guido van Rossum09df08a1998-05-22 00:51:39 +00001380 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001381}
1382
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001383PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001384"pow(x, y[, z]) -> number\n\
1385\n\
1386With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001387equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001388
1389
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001390
Guido van Rossum34343512006-11-30 22:13:52 +00001391static PyObject *
1392builtin_print(PyObject *self, PyObject *args, PyObject *kwds)
1393{
1394 static char *kwlist[] = {"sep", "end", "file", 0};
Georg Brandl257d3d92007-02-26 10:35:10 +00001395 static PyObject *dummy_args;
Guido van Rossum34343512006-11-30 22:13:52 +00001396 PyObject *sep = NULL, *end = NULL, *file = NULL;
1397 int i, err;
1398
Georg Brandl257d3d92007-02-26 10:35:10 +00001399 if (dummy_args == NULL) {
1400 if (!(dummy_args = PyTuple_New(0)))
1401 return NULL;
1402 }
Georg Brandl88fc6642007-02-09 21:28:07 +00001403 if (!PyArg_ParseTupleAndKeywords(dummy_args, kwds, "|OOO:print",
Guido van Rossum34343512006-11-30 22:13:52 +00001404 kwlist, &sep, &end, &file))
1405 return NULL;
1406 if (file == NULL || file == Py_None)
1407 file = PySys_GetObject("stdout");
1408
Georg Brandl16f3e032006-11-30 22:46:03 +00001409 if (sep && sep != Py_None && !PyString_Check(sep) &&
1410 !PyUnicode_Check(sep)) {
1411 PyErr_Format(PyExc_TypeError,
1412 "sep must be None, str or unicode, not %.200s",
1413 sep->ob_type->tp_name);
1414 return NULL;
1415 }
1416 if (end && end != Py_None && !PyString_Check(end) &&
1417 !PyUnicode_Check(end)) {
1418 PyErr_Format(PyExc_TypeError,
1419 "end must be None, str or unicode, not %.200s",
1420 end->ob_type->tp_name);
1421 return NULL;
1422 }
Guido van Rossum34343512006-11-30 22:13:52 +00001423
1424 for (i = 0; i < PyTuple_Size(args); i++) {
1425 if (i > 0) {
1426 if (sep == NULL || sep == Py_None)
1427 err = PyFile_WriteString(" ", file);
1428 else
1429 err = PyFile_WriteObject(sep, file,
1430 Py_PRINT_RAW);
1431 if (err)
1432 return NULL;
1433 }
1434 err = PyFile_WriteObject(PyTuple_GetItem(args, i), file,
1435 Py_PRINT_RAW);
1436 if (err)
1437 return NULL;
1438 }
1439
1440 if (end == NULL || end == Py_None)
1441 err = PyFile_WriteString("\n", file);
1442 else
1443 err = PyFile_WriteObject(end, file, Py_PRINT_RAW);
1444 if (err)
1445 return NULL;
1446
1447 Py_RETURN_NONE;
1448}
1449
1450PyDoc_STRVAR(print_doc,
Guido van Rossum452bf512007-02-09 05:32:43 +00001451"print(value, ..., file=None, sep=' ', end='\\n')\n\
Guido van Rossum34343512006-11-30 22:13:52 +00001452\n\
1453Prints the values to a stream, or to sys.stdout by default.\n\
1454Optional keyword arguments:\n\
1455file: a file-like object (stream); defaults to the current sys.stdout.\n\
1456sep: string inserted between values, default a space.\n\
1457end: string appended after the last value, default a newline.");
1458
1459
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001460/* Return number of items in range (lo, hi, step), when arguments are
1461 * PyInt or PyLong objects. step > 0 required. Return a value < 0 if
1462 * & only if the true value is too large to fit in a signed long.
1463 * Arguments MUST return 1 with either PyInt_Check() or
1464 * PyLong_Check(). Return -1 when there is an error.
1465 */
1466static long
1467get_len_of_range_longs(PyObject *lo, PyObject *hi, PyObject *step)
1468{
1469 /* -------------------------------------------------------------
1470 Algorithm is equal to that of get_len_of_range(), but it operates
1471 on PyObjects (which are assumed to be PyLong or PyInt objects).
1472 ---------------------------------------------------------------*/
1473 long n;
1474 PyObject *diff = NULL;
1475 PyObject *one = NULL;
1476 PyObject *tmp1 = NULL, *tmp2 = NULL, *tmp3 = NULL;
1477 /* holds sub-expression evaluations */
1478
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001479 /* If (lo >= hi), return length of 0 (or error). */
1480 n = PyObject_RichCompareBool(lo, hi, Py_LT);
1481 if (n <= 0)
1482 return n;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001483
1484 if ((one = PyLong_FromLong(1L)) == NULL)
1485 goto Fail;
1486
1487 if ((tmp1 = PyNumber_Subtract(hi, lo)) == NULL)
1488 goto Fail;
1489
1490 if ((diff = PyNumber_Subtract(tmp1, one)) == NULL)
1491 goto Fail;
1492
1493 if ((tmp2 = PyNumber_FloorDivide(diff, step)) == NULL)
1494 goto Fail;
1495
1496 if ((tmp3 = PyNumber_Add(tmp2, one)) == NULL)
1497 goto Fail;
1498
1499 n = PyLong_AsLong(tmp3);
1500 if (PyErr_Occurred()) { /* Check for Overflow */
1501 PyErr_Clear();
1502 goto Fail;
1503 }
1504
1505 Py_DECREF(tmp3);
1506 Py_DECREF(tmp2);
1507 Py_DECREF(diff);
1508 Py_DECREF(tmp1);
1509 Py_DECREF(one);
1510 return n;
1511
1512 Fail:
1513 Py_XDECREF(tmp3);
1514 Py_XDECREF(tmp2);
1515 Py_XDECREF(diff);
1516 Py_XDECREF(tmp1);
1517 Py_XDECREF(one);
1518 return -1;
1519}
1520
1521/* An extension of builtin_range() that handles the case when PyLong
1522 * arguments are given. */
1523static PyObject *
1524handle_range_longs(PyObject *self, PyObject *args)
1525{
1526 PyObject *ilow;
Tim Peters874e1f72003-04-13 22:13:08 +00001527 PyObject *ihigh = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001528 PyObject *istep = NULL;
Tim Peters874e1f72003-04-13 22:13:08 +00001529
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001530 PyObject *curnum = NULL;
1531 PyObject *v = NULL;
1532 long bign;
1533 int i, n;
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001534 int step_pos;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001535
Tim Peters874e1f72003-04-13 22:13:08 +00001536 PyObject *zero = PyLong_FromLong(0);
1537
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001538 if (zero == NULL)
1539 return NULL;
1540
Tim Peters874e1f72003-04-13 22:13:08 +00001541 if (!PyArg_UnpackTuple(args, "range", 1, 3, &ilow, &ihigh, &istep)) {
1542 Py_DECREF(zero);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001543 return NULL;
1544 }
1545
Tim Peters874e1f72003-04-13 22:13:08 +00001546 /* Figure out which way we were called, supply defaults, and be
1547 * sure to incref everything so that the decrefs at the end
1548 * are correct.
1549 */
1550 assert(ilow != NULL);
1551 if (ihigh == NULL) {
1552 /* only 1 arg -- it's the upper limit */
1553 ihigh = ilow;
1554 ilow = NULL;
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001555 }
Tim Peters874e1f72003-04-13 22:13:08 +00001556 assert(ihigh != NULL);
1557 Py_INCREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001558
Tim Peters874e1f72003-04-13 22:13:08 +00001559 /* ihigh correct now; do ilow */
1560 if (ilow == NULL)
1561 ilow = zero;
1562 Py_INCREF(ilow);
1563
1564 /* ilow and ihigh correct now; do istep */
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001565 if (istep == NULL) {
1566 istep = PyLong_FromLong(1L);
1567 if (istep == NULL)
1568 goto Fail;
1569 }
1570 else {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001571 Py_INCREF(istep);
1572 }
1573
Tim Peters874e1f72003-04-13 22:13:08 +00001574 if (!PyInt_Check(ilow) && !PyLong_Check(ilow)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001575 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001576 "range() integer start argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001577 ilow->ob_type->tp_name);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001578 goto Fail;
1579 }
1580
Tim Peters874e1f72003-04-13 22:13:08 +00001581 if (!PyInt_Check(ihigh) && !PyLong_Check(ihigh)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001582 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001583 "range() integer end argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001584 ihigh->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001585 goto Fail;
1586 }
1587
1588 if (!PyInt_Check(istep) && !PyLong_Check(istep)) {
Guido van Rossum28e83e32003-04-15 12:43:26 +00001589 PyErr_Format(PyExc_TypeError,
Alex Martellif471d472003-04-23 13:00:44 +00001590 "range() integer step argument expected, got %s.",
Guido van Rossum817d6c92003-04-14 18:25:04 +00001591 istep->ob_type->tp_name);
Tim Peters874e1f72003-04-13 22:13:08 +00001592 goto Fail;
1593 }
1594
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001595 step_pos = PyObject_RichCompareBool(istep, zero, Py_GT);
1596 if (step_pos < 0)
Tim Peters874e1f72003-04-13 22:13:08 +00001597 goto Fail;
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001598 if (step_pos)
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001599 bign = get_len_of_range_longs(ilow, ihigh, istep);
1600 else {
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001601 int step_zero = PyObject_RichCompareBool(istep, zero, Py_EQ);
Guido van Rossum93a66922006-08-24 02:10:21 +00001602 PyObject *neg_istep;
Guido van Rossum47b9ff62006-08-24 00:41:19 +00001603 if (step_zero < 0)
1604 goto Fail;
1605 if (step_zero) {
1606 PyErr_SetString(PyExc_ValueError,
1607 "range() step argument must not be zero");
1608 goto Fail;
1609 }
Guido van Rossum93a66922006-08-24 02:10:21 +00001610 neg_istep = PyNumber_Negative(istep);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001611 if (neg_istep == NULL)
1612 goto Fail;
1613 bign = get_len_of_range_longs(ihigh, ilow, neg_istep);
1614 Py_DECREF(neg_istep);
1615 }
1616
1617 n = (int)bign;
1618 if (bign < 0 || (long)n != bign) {
1619 PyErr_SetString(PyExc_OverflowError,
1620 "range() result has too many items");
1621 goto Fail;
1622 }
1623
1624 v = PyList_New(n);
1625 if (v == NULL)
1626 goto Fail;
1627
1628 curnum = ilow;
1629 Py_INCREF(curnum);
1630
1631 for (i = 0; i < n; i++) {
1632 PyObject *w = PyNumber_Long(curnum);
1633 PyObject *tmp_num;
1634 if (w == NULL)
1635 goto Fail;
1636
1637 PyList_SET_ITEM(v, i, w);
1638
1639 tmp_num = PyNumber_Add(curnum, istep);
1640 if (tmp_num == NULL)
1641 goto Fail;
1642
1643 Py_DECREF(curnum);
1644 curnum = tmp_num;
1645 }
Tim Peters874e1f72003-04-13 22:13:08 +00001646 Py_DECREF(ilow);
1647 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001648 Py_DECREF(istep);
1649 Py_DECREF(zero);
Tim Peters874e1f72003-04-13 22:13:08 +00001650 Py_DECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001651 return v;
1652
1653 Fail:
Tim Peters874e1f72003-04-13 22:13:08 +00001654 Py_DECREF(ilow);
1655 Py_DECREF(ihigh);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001656 Py_XDECREF(istep);
Tim Peters874e1f72003-04-13 22:13:08 +00001657 Py_DECREF(zero);
1658 Py_XDECREF(curnum);
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001659 Py_XDECREF(v);
1660 return NULL;
1661}
1662
Guido van Rossum124eff01999-02-23 16:11:01 +00001663/* Return number of items in range/xrange (lo, hi, step). step > 0
1664 * required. Return a value < 0 if & only if the true value is too
1665 * large to fit in a signed long.
1666 */
1667static long
Thomas Wouterse28c2962000-07-23 22:21:32 +00001668get_len_of_range(long lo, long hi, long step)
Guido van Rossum124eff01999-02-23 16:11:01 +00001669{
1670 /* -------------------------------------------------------------
1671 If lo >= hi, the range is empty.
1672 Else if n values are in the range, the last one is
1673 lo + (n-1)*step, which must be <= hi-1. Rearranging,
1674 n <= (hi - lo - 1)/step + 1, so taking the floor of the RHS gives
1675 the proper value. Since lo < hi in this case, hi-lo-1 >= 0, so
1676 the RHS is non-negative and so truncation is the same as the
1677 floor. Letting M be the largest positive long, the worst case
1678 for the RHS numerator is hi=M, lo=-M-1, and then
1679 hi-lo-1 = M-(-M-1)-1 = 2*M. Therefore unsigned long has enough
1680 precision to compute the RHS exactly.
1681 ---------------------------------------------------------------*/
1682 long n = 0;
1683 if (lo < hi) {
1684 unsigned long uhi = (unsigned long)hi;
1685 unsigned long ulo = (unsigned long)lo;
1686 unsigned long diff = uhi - ulo - 1;
1687 n = (long)(diff / (unsigned long)step + 1);
1688 }
1689 return n;
1690}
1691
Guido van Rossum79f25d91997-04-29 20:08:16 +00001692static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001693builtin_range(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001694{
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001695 long ilow = 0, ihigh = 0, istep = 1;
Guido van Rossum124eff01999-02-23 16:11:01 +00001696 long bign;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001697 int i, n;
Guido van Rossum124eff01999-02-23 16:11:01 +00001698
Guido van Rossum79f25d91997-04-29 20:08:16 +00001699 PyObject *v;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001700
Guido van Rossum79f25d91997-04-29 20:08:16 +00001701 if (PyTuple_Size(args) <= 1) {
1702 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001703 "l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001704 &ihigh)) {
1705 PyErr_Clear();
1706 return handle_range_longs(self, args);
1707 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001708 }
1709 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001710 if (!PyArg_ParseTuple(args,
Guido van Rossum0865dd91995-01-17 16:30:22 +00001711 "ll|l;range() requires 1-3 int arguments",
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001712 &ilow, &ihigh, &istep)) {
1713 PyErr_Clear();
1714 return handle_range_longs(self, args);
1715 }
Guido van Rossum3f5da241990-12-20 15:06:42 +00001716 }
1717 if (istep == 0) {
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001718 PyErr_SetString(PyExc_ValueError,
Alex Martellif471d472003-04-23 13:00:44 +00001719 "range() step argument must not be zero");
Guido van Rossum3f5da241990-12-20 15:06:42 +00001720 return NULL;
1721 }
Guido van Rossum124eff01999-02-23 16:11:01 +00001722 if (istep > 0)
1723 bign = get_len_of_range(ilow, ihigh, istep);
1724 else
1725 bign = get_len_of_range(ihigh, ilow, -istep);
1726 n = (int)bign;
1727 if (bign < 0 || (long)n != bign) {
Guido van Rossume23cde21999-01-12 05:07:47 +00001728 PyErr_SetString(PyExc_OverflowError,
Fred Drake661ea262000-10-24 19:57:45 +00001729 "range() result has too many items");
Guido van Rossume23cde21999-01-12 05:07:47 +00001730 return NULL;
1731 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00001732 v = PyList_New(n);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001733 if (v == NULL)
1734 return NULL;
1735 for (i = 0; i < n; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001736 PyObject *w = PyInt_FromLong(ilow);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001737 if (w == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001738 Py_DECREF(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001739 return NULL;
1740 }
Guido van Rossuma937d141998-04-24 18:22:02 +00001741 PyList_SET_ITEM(v, i, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001742 ilow += istep;
1743 }
1744 return v;
1745}
1746
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001747PyDoc_STRVAR(range_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001748"range([start,] stop[, step]) -> list of integers\n\
1749\n\
1750Return a list containing an arithmetic progression of integers.\n\
1751range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.\n\
1752When step is given, it specifies the increment (or decrement).\n\
1753For example, range(4) returns [0, 1, 2, 3]. The end point is omitted!\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001754These are exactly the valid indices for a list of 4 elements.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001755
1756
Guido van Rossum79f25d91997-04-29 20:08:16 +00001757static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001758builtin_reload(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001759{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001760 return PyImport_ReloadModule(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001761}
1762
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001763PyDoc_STRVAR(reload_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001764"reload(module) -> module\n\
1765\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001766Reload the module. The module must have been successfully imported before.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001767
1768
Guido van Rossum79f25d91997-04-29 20:08:16 +00001769static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001770builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00001771{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001772 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00001773}
1774
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001775PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001776"repr(object) -> string\n\
1777\n\
1778Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001779For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001780
1781
Guido van Rossum79f25d91997-04-29 20:08:16 +00001782static PyObject *
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001783builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001784{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001785 double number;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001786 double f;
1787 int ndigits = 0;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001788 int i;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001789 static char *kwlist[] = {"number", "ndigits", 0};
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001790
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001791 if (!PyArg_ParseTupleAndKeywords(args, kwds, "d|i:round",
1792 kwlist, &number, &ndigits))
1793 return NULL;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001794 f = 1.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001795 i = abs(ndigits);
1796 while (--i >= 0)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001797 f = f*10.0;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001798 if (ndigits < 0)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001799 number /= f;
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001800 else
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001801 number *= f;
1802 if (number >= 0.0)
1803 number = floor(number + 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001804 else
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001805 number = ceil(number - 0.5);
Guido van Rossum1e162d31998-05-09 14:42:25 +00001806 if (ndigits < 0)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001807 number *= f;
Guido van Rossum1e162d31998-05-09 14:42:25 +00001808 else
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001809 number /= f;
1810 return PyFloat_FromDouble(number);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001811}
1812
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001813PyDoc_STRVAR(round_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001814"round(number[, ndigits]) -> floating point number\n\
1815\n\
1816Round a number to a given precision in decimal digits (default 0 digits).\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001817This always returns a floating point number. Precision may be negative.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001818
Raymond Hettinger64958a12003-12-17 20:43:33 +00001819static PyObject *
1820builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
1821{
1822 PyObject *newlist, *v, *seq, *compare=NULL, *keyfunc=NULL, *newargs;
1823 PyObject *callable;
Martin v. Löwis15e62742006-02-27 16:46:16 +00001824 static char *kwlist[] = {"iterable", "cmp", "key", "reverse", 0};
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001825 int reverse;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001826
Neal Norwitz6f0d4792005-12-15 06:40:36 +00001827 /* args 1-4 should match listsort in Objects/listobject.c */
Armin Rigo71d7e702005-09-20 18:13:03 +00001828 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|OOi:sorted",
1829 kwlist, &seq, &compare, &keyfunc, &reverse))
1830 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001831
1832 newlist = PySequence_List(seq);
1833 if (newlist == NULL)
1834 return NULL;
1835
1836 callable = PyObject_GetAttrString(newlist, "sort");
1837 if (callable == NULL) {
1838 Py_DECREF(newlist);
1839 return NULL;
1840 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001841
Raymond Hettinger64958a12003-12-17 20:43:33 +00001842 newargs = PyTuple_GetSlice(args, 1, 4);
1843 if (newargs == NULL) {
1844 Py_DECREF(newlist);
1845 Py_DECREF(callable);
1846 return NULL;
1847 }
1848
1849 v = PyObject_Call(callable, newargs, kwds);
1850 Py_DECREF(newargs);
1851 Py_DECREF(callable);
1852 if (v == NULL) {
1853 Py_DECREF(newlist);
1854 return NULL;
1855 }
1856 Py_DECREF(v);
1857 return newlist;
1858}
1859
1860PyDoc_STRVAR(sorted_doc,
1861"sorted(iterable, cmp=None, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001862
Guido van Rossum79f25d91997-04-29 20:08:16 +00001863static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001864builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00001865{
Guido van Rossum79f25d91997-04-29 20:08:16 +00001866 PyObject *v = NULL;
1867 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001868
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001869 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001870 return NULL;
Guido van Rossum2d951851994-08-29 12:52:16 +00001871 if (v == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001872 d = PyEval_GetLocals();
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001873 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001874 if (!PyErr_Occurred())
1875 PyErr_SetString(PyExc_SystemError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001876 "vars(): no locals!?");
Guido van Rossum53bb7ff1995-07-26 16:26:31 +00001877 }
1878 else
Guido van Rossum79f25d91997-04-29 20:08:16 +00001879 Py_INCREF(d);
Guido van Rossum2d951851994-08-29 12:52:16 +00001880 }
1881 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001882 d = PyObject_GetAttrString(v, "__dict__");
Guido van Rossum2d951851994-08-29 12:52:16 +00001883 if (d == NULL) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001884 PyErr_SetString(PyExc_TypeError,
Guido van Rossum2d951851994-08-29 12:52:16 +00001885 "vars() argument must have __dict__ attribute");
1886 return NULL;
1887 }
1888 }
1889 return d;
1890}
1891
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001892PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001893"vars([object]) -> dictionary\n\
1894\n\
1895Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001896With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001897
Alex Martellia70b1912003-04-22 08:12:33 +00001898
1899static PyObject*
1900builtin_sum(PyObject *self, PyObject *args)
1901{
1902 PyObject *seq;
1903 PyObject *result = NULL;
1904 PyObject *temp, *item, *iter;
1905
Raymond Hettinger5cf63942003-10-25 06:41:37 +00001906 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
Alex Martellia70b1912003-04-22 08:12:33 +00001907 return NULL;
1908
1909 iter = PyObject_GetIter(seq);
1910 if (iter == NULL)
1911 return NULL;
1912
1913 if (result == NULL) {
1914 result = PyInt_FromLong(0);
1915 if (result == NULL) {
1916 Py_DECREF(iter);
1917 return NULL;
1918 }
1919 } else {
1920 /* reject string values for 'start' parameter */
1921 if (PyObject_TypeCheck(result, &PyBaseString_Type)) {
1922 PyErr_SetString(PyExc_TypeError,
Alex Martellia9b9c9f2003-04-23 13:34:35 +00001923 "sum() can't sum strings [use ''.join(seq) instead]");
Alex Martellia70b1912003-04-22 08:12:33 +00001924 Py_DECREF(iter);
1925 return NULL;
1926 }
Alex Martelli41c9f882003-04-22 09:24:48 +00001927 Py_INCREF(result);
Alex Martellia70b1912003-04-22 08:12:33 +00001928 }
1929
1930 for(;;) {
1931 item = PyIter_Next(iter);
1932 if (item == NULL) {
1933 /* error, or end-of-sequence */
1934 if (PyErr_Occurred()) {
1935 Py_DECREF(result);
1936 result = NULL;
1937 }
1938 break;
1939 }
Alex Martellia253e182003-10-25 23:24:14 +00001940 temp = PyNumber_Add(result, item);
Alex Martellia70b1912003-04-22 08:12:33 +00001941 Py_DECREF(result);
1942 Py_DECREF(item);
1943 result = temp;
1944 if (result == NULL)
1945 break;
1946 }
1947 Py_DECREF(iter);
1948 return result;
1949}
1950
1951PyDoc_STRVAR(sum_doc,
Thomas Wouters89f507f2006-12-13 04:49:30 +00001952"sum(sequence[, start]) -> value\n\
Alex Martellia70b1912003-04-22 08:12:33 +00001953\n\
1954Returns the sum of a sequence of numbers (NOT strings) plus the value\n\
Thomas Wouters89f507f2006-12-13 04:49:30 +00001955of parameter 'start' (which defaults to 0). When the sequence is\n\
1956empty, returns start.");
Alex Martellia70b1912003-04-22 08:12:33 +00001957
1958
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001959static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001960builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001961{
1962 PyObject *inst;
1963 PyObject *cls;
Guido van Rossum823649d2001-03-21 18:40:58 +00001964 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001965
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001966 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001967 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00001968
Guido van Rossum823649d2001-03-21 18:40:58 +00001969 retval = PyObject_IsInstance(inst, cls);
1970 if (retval < 0)
Guido van Rossumad991772001-01-12 16:03:05 +00001971 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00001972 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001973}
1974
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001975PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00001976"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001977\n\
1978Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00001979With a type as second argument, return whether that is the object's type.\n\
1980The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001981isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001982
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001983
1984static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001985builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001986{
1987 PyObject *derived;
1988 PyObject *cls;
1989 int retval;
1990
Raymond Hettingerea3fdf42002-12-29 16:33:45 +00001991 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001992 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00001993
Guido van Rossum823649d2001-03-21 18:40:58 +00001994 retval = PyObject_IsSubclass(derived, cls);
1995 if (retval < 0)
1996 return NULL;
Guido van Rossum77f6a652002-04-03 22:41:51 +00001997 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00001998}
1999
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002000PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002001"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002002\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002003Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2004When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2005is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002006
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002007
Barry Warsawbd599b52000-08-03 15:45:29 +00002008static PyObject*
2009builtin_zip(PyObject *self, PyObject *args)
2010{
Guido van Rossumb65fb332006-08-25 23:26:40 +00002011 /* args must be a tuple */
2012 assert(PyTuple_Check(args));
Barry Warsawbd599b52000-08-03 15:45:29 +00002013
Guido van Rossumb65fb332006-08-25 23:26:40 +00002014 return _PyZip_CreateIter(args);
Barry Warsawbd599b52000-08-03 15:45:29 +00002015}
2016
2017
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002018PyDoc_STRVAR(zip_doc,
Guido van Rossum801f0d72006-08-24 19:48:10 +00002019"zip(it1 [, it2 [...]]) -> iter([(it1[0], it2[0] ...), ...])\n\
Barry Warsawbd599b52000-08-03 15:45:29 +00002020\n\
Guido van Rossum801f0d72006-08-24 19:48:10 +00002021Return an iterator yielding tuples, where each tuple contains the\n\
2022corresponding element from each of the argument iterables.\n\
2023The returned iterator ends when the shortest argument iterable is exhausted.\n\
2024NOTE: This is implemented using itertools.izip().");
Barry Warsawbd599b52000-08-03 15:45:29 +00002025
2026
Guido van Rossum79f25d91997-04-29 20:08:16 +00002027static PyMethodDef builtin_methods[] = {
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002028 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002029 {"abs", builtin_abs, METH_O, abs_doc},
Raymond Hettinger96229b12005-03-11 06:49:40 +00002030 {"all", builtin_all, METH_O, all_doc},
2031 {"any", builtin_any, METH_O, any_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002032 {"callable", builtin_callable, METH_O, callable_doc},
2033 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2034 {"cmp", builtin_cmp, METH_VARARGS, cmp_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002035 {"compile", builtin_compile, METH_VARARGS, compile_doc},
2036 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2037 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2038 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2039 {"eval", builtin_eval, METH_VARARGS, eval_doc},
Georg Brandl7cae87c2006-09-06 06:51:57 +00002040 {"exec", builtin_exec, METH_VARARGS, exec_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002041 {"execfile", builtin_execfile, METH_VARARGS, execfile_doc},
2042 {"filter", builtin_filter, METH_VARARGS, filter_doc},
2043 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2044 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2045 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2046 {"hash", builtin_hash, METH_O, hash_doc},
2047 {"hex", builtin_hex, METH_O, hex_doc},
2048 {"id", builtin_id, METH_O, id_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002049 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2050 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2051 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2052 {"len", builtin_len, METH_O, len_doc},
2053 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2054 {"map", builtin_map, METH_VARARGS, map_doc},
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00002055 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2056 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002057 {"oct", builtin_oct, METH_O, oct_doc},
Thomas Wouters477c8d52006-05-27 19:21:47 +00002058 {"open", (PyCFunction)builtin_open, METH_VARARGS | METH_KEYWORDS, open_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002059 {"ord", builtin_ord, METH_O, ord_doc},
2060 {"pow", builtin_pow, METH_VARARGS, pow_doc},
Guido van Rossum452bf512007-02-09 05:32:43 +00002061 {"print", (PyCFunction)builtin_print, METH_VARARGS | METH_KEYWORDS, print_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002062 {"range", builtin_range, METH_VARARGS, range_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002063 {"reload", builtin_reload, METH_O, reload_doc},
2064 {"repr", builtin_repr, METH_O, repr_doc},
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002065 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002066 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
Raymond Hettinger64958a12003-12-17 20:43:33 +00002067 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
Alex Martellia70b1912003-04-22 08:12:33 +00002068 {"sum", builtin_sum, METH_VARARGS, sum_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002069#ifdef Py_USING_UNICODE
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002070 {"unichr", builtin_unichr, METH_VARARGS, unichr_doc},
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002071#endif
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002072 {"vars", builtin_vars, METH_VARARGS, vars_doc},
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00002073 {"zip", builtin_zip, METH_VARARGS, zip_doc},
Guido van Rossumc02e15c1991-12-16 13:03:00 +00002074 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002075};
2076
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002077PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002078"Built-in functions, exceptions, and other objects.\n\
2079\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002080Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002081
Guido van Rossum25ce5661997-08-02 03:10:38 +00002082PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002083_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002084{
Fred Drake5550de32000-06-20 04:54:19 +00002085 PyObject *mod, *dict, *debug;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002086 mod = Py_InitModule4("__builtin__", builtin_methods,
2087 builtin_doc, (PyObject *)NULL,
2088 PYTHON_API_VERSION);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002089 if (mod == NULL)
2090 return NULL;
2091 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002092
Tim Peters7571a0f2003-03-23 17:52:28 +00002093#ifdef Py_TRACE_REFS
2094 /* __builtin__ exposes a number of statically allocated objects
2095 * that, before this code was added in 2.3, never showed up in
2096 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2097 * result, programs leaking references to None and False (etc)
2098 * couldn't be diagnosed by examining sys.getobjects(0).
2099 */
2100#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2101#else
2102#define ADD_TO_ALL(OBJECT) (void)0
2103#endif
2104
Tim Peters4b7625e2001-09-13 21:37:17 +00002105#define SETBUILTIN(NAME, OBJECT) \
Tim Peters7571a0f2003-03-23 17:52:28 +00002106 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2107 return NULL; \
2108 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002109
2110 SETBUILTIN("None", Py_None);
2111 SETBUILTIN("Ellipsis", Py_Ellipsis);
2112 SETBUILTIN("NotImplemented", Py_NotImplemented);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002113 SETBUILTIN("False", Py_False);
2114 SETBUILTIN("True", Py_True);
Neal Norwitz32a7e7f2002-05-31 19:58:02 +00002115 SETBUILTIN("basestring", &PyBaseString_Type);
Guido van Rossum77f6a652002-04-03 22:41:51 +00002116 SETBUILTIN("bool", &PyBool_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002117 SETBUILTIN("buffer", &PyBuffer_Type);
Guido van Rossum4dfe8a12006-04-22 23:28:04 +00002118 SETBUILTIN("bytes", &PyBytes_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002119 SETBUILTIN("classmethod", &PyClassMethod_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002120#ifndef WITHOUT_COMPLEX
Tim Peters4b7625e2001-09-13 21:37:17 +00002121 SETBUILTIN("complex", &PyComplex_Type);
Tim Peters6d6c1a32001-08-02 04:15:00 +00002122#endif
Tim Petersa427a2b2001-10-29 22:25:45 +00002123 SETBUILTIN("dict", &PyDict_Type);
Tim Peters67d687a2002-04-29 21:27:32 +00002124 SETBUILTIN("enumerate", &PyEnum_Type);
Thomas Wouters477c8d52006-05-27 19:21:47 +00002125 SETBUILTIN("file", &PyFile_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002126 SETBUILTIN("float", &PyFloat_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002127 SETBUILTIN("frozenset", &PyFrozenSet_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002128 SETBUILTIN("property", &PyProperty_Type);
Guido van Rossumddefaf32007-01-14 03:31:43 +00002129 SETBUILTIN("int", &PyLong_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002130 SETBUILTIN("list", &PyList_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002131 SETBUILTIN("object", &PyBaseObject_Type);
Raymond Hettinger85c20a42003-11-06 14:06:48 +00002132 SETBUILTIN("reversed", &PyReversed_Type);
Raymond Hettingera690a992003-11-16 16:17:49 +00002133 SETBUILTIN("set", &PySet_Type);
Guido van Rossumbea18cc2002-06-14 20:41:17 +00002134 SETBUILTIN("slice", &PySlice_Type);
Tim Peters4b7625e2001-09-13 21:37:17 +00002135 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2136 SETBUILTIN("str", &PyString_Type);
2137 SETBUILTIN("super", &PySuper_Type);
2138 SETBUILTIN("tuple", &PyTuple_Type);
2139 SETBUILTIN("type", &PyType_Type);
Raymond Hettingerc4c453f2002-06-05 23:12:45 +00002140 SETBUILTIN("xrange", &PyRange_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002141#ifdef Py_USING_UNICODE
Tim Peters4b7625e2001-09-13 21:37:17 +00002142 SETBUILTIN("unicode", &PyUnicode_Type);
Martin v. Löwis339d0f72001-08-17 18:39:25 +00002143#endif
Guido van Rossum77f6a652002-04-03 22:41:51 +00002144 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
Fred Drake5550de32000-06-20 04:54:19 +00002145 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2146 Py_XDECREF(debug);
Guido van Rossum25ce5661997-08-02 03:10:38 +00002147 return NULL;
Fred Drake5550de32000-06-20 04:54:19 +00002148 }
2149 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002150
Guido van Rossum25ce5661997-08-02 03:10:38 +00002151 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002152#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002153#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002154}
2155
Guido van Rossume77a7571993-11-03 15:01:26 +00002156/* Helper for filter(): filter a tuple through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002157
Guido van Rossum79f25d91997-04-29 20:08:16 +00002158static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002159filtertuple(PyObject *func, PyObject *tuple)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002160{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002161 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002162 Py_ssize_t i, j;
2163 Py_ssize_t len = PyTuple_Size(tuple);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002164
Guido van Rossumb7b45621995-08-04 04:07:45 +00002165 if (len == 0) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002166 if (PyTuple_CheckExact(tuple))
2167 Py_INCREF(tuple);
2168 else
2169 tuple = PyTuple_New(0);
Guido van Rossumb7b45621995-08-04 04:07:45 +00002170 return tuple;
2171 }
2172
Guido van Rossum79f25d91997-04-29 20:08:16 +00002173 if ((result = PyTuple_New(len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002174 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002175
Guido van Rossum12d12c51993-10-26 17:58:25 +00002176 for (i = j = 0; i < len; ++i) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002177 PyObject *item, *good;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002178 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002179
Walter Dörwald8dd19322003-02-10 17:36:40 +00002180 if (tuple->ob_type->tp_as_sequence &&
2181 tuple->ob_type->tp_as_sequence->sq_item) {
2182 item = tuple->ob_type->tp_as_sequence->sq_item(tuple, i);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002183 if (item == NULL)
2184 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002185 } else {
Alex Martellia9b9c9f2003-04-23 13:34:35 +00002186 PyErr_SetString(PyExc_TypeError, "filter(): unsubscriptable tuple");
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002187 goto Fail_1;
Walter Dörwald8dd19322003-02-10 17:36:40 +00002188 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002189 if (func == Py_None) {
2190 Py_INCREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002191 good = item;
2192 }
2193 else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002194 PyObject *arg = PyTuple_Pack(1, item);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002195 if (arg == NULL) {
2196 Py_DECREF(item);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002197 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002198 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002199 good = PyEval_CallObject(func, arg);
2200 Py_DECREF(arg);
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002201 if (good == NULL) {
2202 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002203 goto Fail_1;
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002204 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002205 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002206 ok = PyObject_IsTrue(good);
2207 Py_DECREF(good);
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002208 if (ok) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00002209 if (PyTuple_SetItem(result, j++, item) < 0)
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002210 goto Fail_1;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002211 }
Walter Dörwaldc58a3a12003-08-18 18:28:45 +00002212 else
2213 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002214 }
2215
Tim Peters4324aa32001-05-28 22:30:08 +00002216 if (_PyTuple_Resize(&result, j) < 0)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002217 return NULL;
2218
Guido van Rossum12d12c51993-10-26 17:58:25 +00002219 return result;
2220
Guido van Rossum12d12c51993-10-26 17:58:25 +00002221Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002222 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002223 return NULL;
2224}
2225
2226
Guido van Rossume77a7571993-11-03 15:01:26 +00002227/* Helper for filter(): filter a string through a function */
Guido van Rossum12d12c51993-10-26 17:58:25 +00002228
Guido van Rossum79f25d91997-04-29 20:08:16 +00002229static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002230filterstring(PyObject *func, PyObject *strobj)
Guido van Rossum12d12c51993-10-26 17:58:25 +00002231{
Guido van Rossum79f25d91997-04-29 20:08:16 +00002232 PyObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002233 Py_ssize_t i, j;
2234 Py_ssize_t len = PyString_Size(strobj);
2235 Py_ssize_t outlen = len;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002236
Guido van Rossum79f25d91997-04-29 20:08:16 +00002237 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002238 /* If it's a real string we can return the original,
2239 * as no character is ever false and __getitem__
2240 * does return this character. If it's a subclass
2241 * we must go through the __getitem__ loop */
2242 if (PyString_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002243 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002244 return strobj;
2245 }
Guido van Rossum12d12c51993-10-26 17:58:25 +00002246 }
Guido van Rossum79f25d91997-04-29 20:08:16 +00002247 if ((result = PyString_FromStringAndSize(NULL, len)) == NULL)
Guido van Rossum2586bf01993-11-01 16:21:44 +00002248 return NULL;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002249
Guido van Rossum12d12c51993-10-26 17:58:25 +00002250 for (i = j = 0; i < len; ++i) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002251 PyObject *item;
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002252 int ok;
Guido van Rossum12d12c51993-10-26 17:58:25 +00002253
Guido van Rossumdc4b93d1993-10-27 14:56:44 +00002254 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2255 if (item == NULL)
2256 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002257 if (func==Py_None) {
2258 ok = 1;
2259 } else {
2260 PyObject *arg, *good;
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002261 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002262 if (arg == NULL) {
2263 Py_DECREF(item);
2264 goto Fail_1;
2265 }
2266 good = PyEval_CallObject(func, arg);
2267 Py_DECREF(arg);
2268 if (good == NULL) {
2269 Py_DECREF(item);
2270 goto Fail_1;
2271 }
2272 ok = PyObject_IsTrue(good);
2273 Py_DECREF(good);
Tim Peters388ed082001-04-07 20:34:48 +00002274 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002275 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002276 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002277 if (!PyString_Check(item)) {
2278 PyErr_SetString(PyExc_TypeError, "can't filter str to str:"
2279 " __getitem__ returned different type");
2280 Py_DECREF(item);
2281 goto Fail_1;
2282 }
2283 reslen = PyString_GET_SIZE(item);
2284 if (reslen == 1) {
2285 PyString_AS_STRING(result)[j++] =
2286 PyString_AS_STRING(item)[0];
2287 } else {
2288 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002289 Py_ssize_t need = j + reslen + len-i-1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002290 if (need > outlen) {
2291 /* overallocate, to avoid reallocations */
2292 if (need<2*outlen)
2293 need = 2*outlen;
2294 if (_PyString_Resize(&result, need)) {
2295 Py_DECREF(item);
2296 return NULL;
2297 }
2298 outlen = need;
2299 }
2300 memcpy(
2301 PyString_AS_STRING(result) + j,
2302 PyString_AS_STRING(item),
2303 reslen
2304 );
2305 j += reslen;
2306 }
2307 }
Tim Peters388ed082001-04-07 20:34:48 +00002308 Py_DECREF(item);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002309 }
2310
Walter Dörwald903f1e02003-02-04 16:28:00 +00002311 if (j < outlen)
Tim Peters5de98422002-04-27 18:44:32 +00002312 _PyString_Resize(&result, j);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002313
Guido van Rossum12d12c51993-10-26 17:58:25 +00002314 return result;
2315
Guido van Rossum12d12c51993-10-26 17:58:25 +00002316Fail_1:
Guido van Rossum79f25d91997-04-29 20:08:16 +00002317 Py_DECREF(result);
Guido van Rossum12d12c51993-10-26 17:58:25 +00002318 return NULL;
2319}
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002320
2321#ifdef Py_USING_UNICODE
2322/* Helper for filter(): filter a Unicode object through a function */
2323
2324static PyObject *
2325filterunicode(PyObject *func, PyObject *strobj)
2326{
2327 PyObject *result;
Martin v. Löwis725507b2006-03-07 12:08:51 +00002328 register Py_ssize_t i, j;
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002329 Py_ssize_t len = PyUnicode_GetSize(strobj);
2330 Py_ssize_t outlen = len;
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002331
2332 if (func == Py_None) {
Walter Dörwald1918f772003-02-10 13:19:13 +00002333 /* If it's a real string we can return the original,
2334 * as no character is ever false and __getitem__
2335 * does return this character. If it's a subclass
2336 * we must go through the __getitem__ loop */
2337 if (PyUnicode_CheckExact(strobj)) {
Walter Dörwaldc3da83f2003-02-04 20:24:45 +00002338 Py_INCREF(strobj);
Walter Dörwald1918f772003-02-10 13:19:13 +00002339 return strobj;
2340 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002341 }
2342 if ((result = PyUnicode_FromUnicode(NULL, len)) == NULL)
2343 return NULL;
2344
2345 for (i = j = 0; i < len; ++i) {
2346 PyObject *item, *arg, *good;
2347 int ok;
2348
2349 item = (*strobj->ob_type->tp_as_sequence->sq_item)(strobj, i);
2350 if (item == NULL)
2351 goto Fail_1;
Walter Dörwald1918f772003-02-10 13:19:13 +00002352 if (func == Py_None) {
2353 ok = 1;
2354 } else {
Raymond Hettinger8ae46892003-10-12 19:09:37 +00002355 arg = PyTuple_Pack(1, item);
Walter Dörwald1918f772003-02-10 13:19:13 +00002356 if (arg == NULL) {
2357 Py_DECREF(item);
2358 goto Fail_1;
2359 }
2360 good = PyEval_CallObject(func, arg);
2361 Py_DECREF(arg);
2362 if (good == NULL) {
2363 Py_DECREF(item);
2364 goto Fail_1;
2365 }
2366 ok = PyObject_IsTrue(good);
2367 Py_DECREF(good);
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002368 }
Walter Dörwald903f1e02003-02-04 16:28:00 +00002369 if (ok) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002370 Py_ssize_t reslen;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002371 if (!PyUnicode_Check(item)) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002372 PyErr_SetString(PyExc_TypeError,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002373 "can't filter unicode to unicode:"
2374 " __getitem__ returned different type");
Walter Dörwald903f1e02003-02-04 16:28:00 +00002375 Py_DECREF(item);
2376 goto Fail_1;
2377 }
2378 reslen = PyUnicode_GET_SIZE(item);
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002379 if (reslen == 1)
Walter Dörwald903f1e02003-02-04 16:28:00 +00002380 PyUnicode_AS_UNICODE(result)[j++] =
2381 PyUnicode_AS_UNICODE(item)[0];
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002382 else {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002383 /* do we need more space? */
Martin v. Löwisd96ee902006-02-16 14:37:16 +00002384 Py_ssize_t need = j + reslen + len - i - 1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002385 if (need > outlen) {
Georg Brandl99d7e4e2005-08-31 22:21:15 +00002386 /* overallocate,
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002387 to avoid reallocations */
2388 if (need < 2 * outlen)
2389 need = 2 * outlen;
Jeremy Hylton364f6be2003-09-16 03:17:16 +00002390 if (PyUnicode_Resize(
2391 &result, need) < 0) {
Walter Dörwald903f1e02003-02-04 16:28:00 +00002392 Py_DECREF(item);
Walter Dörwald531e0002003-02-04 16:57:49 +00002393 goto Fail_1;
Walter Dörwald903f1e02003-02-04 16:28:00 +00002394 }
2395 outlen = need;
2396 }
Jeremy Hylton1aad9c72003-09-16 03:10:59 +00002397 memcpy(PyUnicode_AS_UNICODE(result) + j,
2398 PyUnicode_AS_UNICODE(item),
2399 reslen*sizeof(Py_UNICODE));
Walter Dörwald903f1e02003-02-04 16:28:00 +00002400 j += reslen;
2401 }
2402 }
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002403 Py_DECREF(item);
2404 }
2405
Walter Dörwald903f1e02003-02-04 16:28:00 +00002406 if (j < outlen)
Martin v. Löwis8afd7572003-01-25 22:46:11 +00002407 PyUnicode_Resize(&result, j);
2408
2409 return result;
2410
2411Fail_1:
2412 Py_DECREF(result);
2413 return NULL;
2414}
2415#endif