blob: d1630cc3da69f8b30f463960d9d7888e2a4727a2 [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"
Martin v. Löwis618dc5e2008-03-30 20:03:44 +00004#include "Python-ast.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00005
6#include "node.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00007#include "code.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00008
Benjamin Petersonea281a52011-08-12 23:10:50 -05009#include "asdl.h"
10#include "ast.h"
11
Guido van Rossum6bf62da1997-04-11 20:37:35 +000012#include <ctype.h>
13
Victor Stinnerb744ba12010-05-15 12:27:16 +000014#ifdef HAVE_LANGINFO_H
15#include <langinfo.h> /* CODESET */
16#endif
17
Mark Hammond26cffde2001-05-14 12:17:34 +000018/* The default encoding used by the platform file system APIs
19 Can remain NULL for all platforms that don't have such a concept
Guido van Rossum00bc0e02007-10-15 02:52:41 +000020
21 Don't forget to modify PyUnicode_DecodeFSDefault() if you touch any of the
22 values for Py_FileSystemDefaultEncoding!
Mark Hammond26cffde2001-05-14 12:17:34 +000023*/
Victor Stinner99b95382011-07-04 14:23:54 +020024#ifdef HAVE_MBCS
Mark Hammond26cffde2001-05-14 12:17:34 +000025const char *Py_FileSystemDefaultEncoding = "mbcs";
Martin v. Löwis04dc25c2008-10-03 16:09:28 +000026int Py_HasFileSystemDefaultEncoding = 1;
Just van Rossumb9b8e9c2003-02-10 09:22:01 +000027#elif defined(__APPLE__)
28const char *Py_FileSystemDefaultEncoding = "utf-8";
Martin v. Löwis04dc25c2008-10-03 16:09:28 +000029int Py_HasFileSystemDefaultEncoding = 1;
Victor Stinnerd64e8a72011-07-04 13:48:30 +020030#else
Victor Stinnerb744ba12010-05-15 12:27:16 +000031const char *Py_FileSystemDefaultEncoding = NULL; /* set by initfsencoding() */
Martin v. Löwis04dc25c2008-10-03 16:09:28 +000032int Py_HasFileSystemDefaultEncoding = 0;
Mark Hammond26cffde2001-05-14 12:17:34 +000033#endif
Mark Hammondef8b6542001-05-13 08:04:26 +000034
Martin v. Löwisbd928fe2011-10-14 10:20:37 +020035_Py_IDENTIFIER(fileno);
36_Py_IDENTIFIER(flush);
Martin v. Löwisafe55bb2011-10-09 10:38:36 +020037
Guido van Rossum79f25d91997-04-29 20:08:16 +000038static PyObject *
Guido van Rossum52cc1d82007-03-18 15:41:51 +000039builtin___build_class__(PyObject *self, PyObject *args, PyObject *kwds)
40{
Nick Coghlande31b192011-10-23 22:04:16 +100041 PyObject *func, *name, *bases, *mkw, *meta, *winner, *prep, *ns, *cell;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000042 PyObject *cls = NULL;
Florent Xicluna4d46c2a2011-10-28 15:00:50 +020043 Py_ssize_t nargs;
Nick Coghlande31b192011-10-23 22:04:16 +100044 int isclass;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +020045 _Py_IDENTIFIER(__prepare__);
Guido van Rossum52cc1d82007-03-18 15:41:51 +000046
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000047 assert(args != NULL);
48 if (!PyTuple_Check(args)) {
49 PyErr_SetString(PyExc_TypeError,
50 "__build_class__: args is not a tuple");
51 return NULL;
52 }
53 nargs = PyTuple_GET_SIZE(args);
54 if (nargs < 2) {
55 PyErr_SetString(PyExc_TypeError,
56 "__build_class__: not enough arguments");
57 return NULL;
58 }
59 func = PyTuple_GET_ITEM(args, 0); /* Better be callable */
60 name = PyTuple_GET_ITEM(args, 1);
61 if (!PyUnicode_Check(name)) {
62 PyErr_SetString(PyExc_TypeError,
63 "__build_class__: name is not a string");
64 return NULL;
65 }
66 bases = PyTuple_GetSlice(args, 2, nargs);
67 if (bases == NULL)
68 return NULL;
Guido van Rossum52cc1d82007-03-18 15:41:51 +000069
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000070 if (kwds == NULL) {
71 meta = NULL;
72 mkw = NULL;
73 }
74 else {
75 mkw = PyDict_Copy(kwds); /* Don't modify kwds passed in! */
76 if (mkw == NULL) {
77 Py_DECREF(bases);
78 return NULL;
Guido van Rossum52cc1d82007-03-18 15:41:51 +000079 }
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000080 meta = PyDict_GetItemString(mkw, "metaclass");
81 if (meta != NULL) {
82 Py_INCREF(meta);
83 if (PyDict_DelItemString(mkw, "metaclass") < 0) {
84 Py_DECREF(meta);
85 Py_DECREF(mkw);
86 Py_DECREF(bases);
87 return NULL;
88 }
Nick Coghlande31b192011-10-23 22:04:16 +100089 /* metaclass is explicitly given, check if it's indeed a class */
90 isclass = PyType_Check(meta);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000091 }
92 }
93 if (meta == NULL) {
Nick Coghlande31b192011-10-23 22:04:16 +100094 /* if there are no bases, use type: */
95 if (PyTuple_GET_SIZE(bases) == 0) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000096 meta = (PyObject *) (&PyType_Type);
Nick Coghlande31b192011-10-23 22:04:16 +100097 }
98 /* else get the type of the first base */
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000099 else {
100 PyObject *base0 = PyTuple_GET_ITEM(bases, 0);
101 meta = (PyObject *) (base0->ob_type);
102 }
103 Py_INCREF(meta);
Nick Coghlande31b192011-10-23 22:04:16 +1000104 isclass = 1; /* meta is really a class */
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000105 }
Nick Coghlan9715d262011-10-23 22:36:42 +1000106
Nick Coghlande31b192011-10-23 22:04:16 +1000107 if (isclass) {
108 /* meta is really a class, so check for a more derived
109 metaclass, or possible metaclass conflicts: */
110 winner = (PyObject *)_PyType_CalculateMetaclass((PyTypeObject *)meta,
111 bases);
112 if (winner == NULL) {
113 Py_DECREF(meta);
114 Py_XDECREF(mkw);
115 Py_DECREF(bases);
116 return NULL;
117 }
118 if (winner != meta) {
119 Py_DECREF(meta);
120 meta = winner;
121 Py_INCREF(meta);
122 }
123 }
124 /* else: meta is not a class, so we cannot do the metaclass
125 calculation, so we will use the explicitly given object as it is */
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +0200126 prep = _PyObject_GetAttrId(meta, &PyId___prepare__);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000127 if (prep == NULL) {
128 if (PyErr_ExceptionMatches(PyExc_AttributeError)) {
129 PyErr_Clear();
130 ns = PyDict_New();
131 }
132 else {
133 Py_DECREF(meta);
134 Py_XDECREF(mkw);
135 Py_DECREF(bases);
136 return NULL;
137 }
138 }
139 else {
140 PyObject *pargs = PyTuple_Pack(2, name, bases);
141 if (pargs == NULL) {
142 Py_DECREF(prep);
143 Py_DECREF(meta);
144 Py_XDECREF(mkw);
145 Py_DECREF(bases);
146 return NULL;
147 }
148 ns = PyEval_CallObjectWithKeywords(prep, pargs, mkw);
149 Py_DECREF(pargs);
150 Py_DECREF(prep);
151 }
152 if (ns == NULL) {
153 Py_DECREF(meta);
154 Py_XDECREF(mkw);
155 Py_DECREF(bases);
156 return NULL;
157 }
158 cell = PyObject_CallFunctionObjArgs(func, ns, NULL);
159 if (cell != NULL) {
160 PyObject *margs;
161 margs = PyTuple_Pack(3, name, bases, ns);
162 if (margs != NULL) {
163 cls = PyEval_CallObjectWithKeywords(meta, margs, mkw);
164 Py_DECREF(margs);
165 }
166 if (cls != NULL && PyCell_Check(cell)) {
167 Py_INCREF(cls);
168 PyCell_SET(cell, cls);
169 }
170 Py_DECREF(cell);
171 }
172 Py_DECREF(ns);
173 Py_DECREF(meta);
174 Py_XDECREF(mkw);
175 Py_DECREF(bases);
176 return cls;
Guido van Rossum52cc1d82007-03-18 15:41:51 +0000177}
178
179PyDoc_STRVAR(build_class_doc,
180"__build_class__(func, name, *bases, metaclass=None, **kwds) -> class\n\
181\n\
182Internal helper function used by the class statement.");
183
184static PyObject *
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000185builtin___import__(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000186{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000187 static char *kwlist[] = {"name", "globals", "locals", "fromlist",
188 "level", 0};
Victor Stinnerfe93faf2011-03-14 15:54:52 -0400189 PyObject *name, *globals = NULL, *locals = NULL, *fromlist = NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000190 int level = -1;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000191
Victor Stinnerfe93faf2011-03-14 15:54:52 -0400192 if (!PyArg_ParseTupleAndKeywords(args, kwds, "U|OOOi:__import__",
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000193 kwlist, &name, &globals, &locals, &fromlist, &level))
194 return NULL;
Victor Stinnerfe93faf2011-03-14 15:54:52 -0400195 return PyImport_ImportModuleLevelObject(name, globals, locals,
196 fromlist, level);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000197}
198
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000199PyDoc_STRVAR(import_doc,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000200"__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000201\n\
Brett Cannon5305a992010-09-27 21:08:38 +0000202Import a module. Because this function is meant for use by the Python\n\
203interpreter and not for general use it is better to use\n\
204importlib.import_module() to programmatically import a module.\n\
205\n\
206The globals argument is only used to determine the context;\n\
207they are not modified. The locals argument is unused. The fromlist\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000208should be a list of names to emulate ``from name import ...'', or an\n\
209empty list to emulate ``import name''.\n\
210When importing a module from a package, note that __import__('A.B', ...)\n\
211returns package A when fromlist is empty, but its submodule B when\n\
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000212fromlist is not empty. Level is used to determine whether to perform \n\
213absolute or relative imports. -1 is the original strategy of attempting\n\
214both absolute and relative imports, 0 is absolute, a positive number\n\
215is the number of parent directories to search relative to the current module.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000216
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000217
Guido van Rossum79f25d91997-04-29 20:08:16 +0000218static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000219builtin_abs(PyObject *self, PyObject *v)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000220{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000221 return PyNumber_Absolute(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000222}
223
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000224PyDoc_STRVAR(abs_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000225"abs(number) -> number\n\
226\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000227Return the absolute value of the argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000228
Raymond Hettinger96229b12005-03-11 06:49:40 +0000229static PyObject *
230builtin_all(PyObject *self, PyObject *v)
231{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000232 PyObject *it, *item;
233 PyObject *(*iternext)(PyObject *);
234 int cmp;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000235
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000236 it = PyObject_GetIter(v);
237 if (it == NULL)
238 return NULL;
239 iternext = *Py_TYPE(it)->tp_iternext;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000240
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000241 for (;;) {
242 item = iternext(it);
243 if (item == NULL)
244 break;
245 cmp = PyObject_IsTrue(item);
246 Py_DECREF(item);
247 if (cmp < 0) {
248 Py_DECREF(it);
249 return NULL;
250 }
251 if (cmp == 0) {
252 Py_DECREF(it);
253 Py_RETURN_FALSE;
254 }
255 }
256 Py_DECREF(it);
257 if (PyErr_Occurred()) {
258 if (PyErr_ExceptionMatches(PyExc_StopIteration))
259 PyErr_Clear();
260 else
261 return NULL;
262 }
263 Py_RETURN_TRUE;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000264}
265
266PyDoc_STRVAR(all_doc,
267"all(iterable) -> bool\n\
268\n\
269Return True if bool(x) is True for all values x in the iterable.");
270
271static PyObject *
272builtin_any(PyObject *self, PyObject *v)
273{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000274 PyObject *it, *item;
275 PyObject *(*iternext)(PyObject *);
276 int cmp;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000277
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000278 it = PyObject_GetIter(v);
279 if (it == NULL)
280 return NULL;
281 iternext = *Py_TYPE(it)->tp_iternext;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000282
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000283 for (;;) {
284 item = iternext(it);
285 if (item == NULL)
286 break;
287 cmp = PyObject_IsTrue(item);
288 Py_DECREF(item);
289 if (cmp < 0) {
290 Py_DECREF(it);
291 return NULL;
292 }
293 if (cmp == 1) {
294 Py_DECREF(it);
295 Py_RETURN_TRUE;
296 }
297 }
298 Py_DECREF(it);
299 if (PyErr_Occurred()) {
300 if (PyErr_ExceptionMatches(PyExc_StopIteration))
301 PyErr_Clear();
302 else
303 return NULL;
304 }
305 Py_RETURN_FALSE;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000306}
307
308PyDoc_STRVAR(any_doc,
309"any(iterable) -> bool\n\
310\n\
311Return True if bool(x) is True for any x in the iterable.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000312
Georg Brandl559e5d72008-06-11 18:37:52 +0000313static PyObject *
314builtin_ascii(PyObject *self, PyObject *v)
315{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000316 return PyObject_ASCII(v);
Georg Brandl559e5d72008-06-11 18:37:52 +0000317}
318
319PyDoc_STRVAR(ascii_doc,
320"ascii(object) -> string\n\
321\n\
322As repr(), return a string containing a printable representation of an\n\
323object, but escape the non-ASCII characters in the string returned by\n\
324repr() using \\x, \\u or \\U escapes. This generates a string similar\n\
325to that returned by repr() in Python 2.");
326
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000327
Guido van Rossum79f25d91997-04-29 20:08:16 +0000328static PyObject *
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000329builtin_bin(PyObject *self, PyObject *v)
330{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000331 return PyNumber_ToBase(v, 2);
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000332}
333
334PyDoc_STRVAR(bin_doc,
335"bin(number) -> string\n\
336\n\
Alexander Belopolsky12338ab2011-04-07 00:15:33 -0400337Return the binary representation of an integer.");
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000338
339
Antoine Pitroue71362d2010-11-27 22:00:11 +0000340static PyObject *
341builtin_callable(PyObject *self, PyObject *v)
342{
343 return PyBool_FromLong((long)PyCallable_Check(v));
344}
345
346PyDoc_STRVAR(callable_doc,
347"callable(object) -> bool\n\
348\n\
349Return whether the object is callable (i.e., some kind of function).\n\
350Note that classes are callable, as are instances of classes with a\n\
351__call__() method.");
352
353
Raymond Hettinger17301e92008-03-13 00:19:26 +0000354typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000355 PyObject_HEAD
356 PyObject *func;
357 PyObject *it;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000358} filterobject;
359
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000360static PyObject *
Raymond Hettinger17301e92008-03-13 00:19:26 +0000361filter_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000362{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000363 PyObject *func, *seq;
364 PyObject *it;
365 filterobject *lz;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000366
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000367 if (type == &PyFilter_Type && !_PyArg_NoKeywords("filter()", kwds))
368 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000369
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000370 if (!PyArg_UnpackTuple(args, "filter", 2, 2, &func, &seq))
371 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000372
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000373 /* Get iterator. */
374 it = PyObject_GetIter(seq);
375 if (it == NULL)
376 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000377
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000378 /* create filterobject structure */
379 lz = (filterobject *)type->tp_alloc(type, 0);
380 if (lz == NULL) {
381 Py_DECREF(it);
382 return NULL;
383 }
384 Py_INCREF(func);
385 lz->func = func;
386 lz->it = it;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000387
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000388 return (PyObject *)lz;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000389}
390
391static void
392filter_dealloc(filterobject *lz)
393{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000394 PyObject_GC_UnTrack(lz);
395 Py_XDECREF(lz->func);
396 Py_XDECREF(lz->it);
397 Py_TYPE(lz)->tp_free(lz);
Raymond Hettinger17301e92008-03-13 00:19:26 +0000398}
399
400static int
401filter_traverse(filterobject *lz, visitproc visit, void *arg)
402{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000403 Py_VISIT(lz->it);
404 Py_VISIT(lz->func);
405 return 0;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000406}
407
408static PyObject *
409filter_next(filterobject *lz)
410{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000411 PyObject *item;
412 PyObject *it = lz->it;
413 long ok;
414 PyObject *(*iternext)(PyObject *);
Raymond Hettinger17301e92008-03-13 00:19:26 +0000415
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000416 iternext = *Py_TYPE(it)->tp_iternext;
417 for (;;) {
418 item = iternext(it);
419 if (item == NULL)
420 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000421
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000422 if (lz->func == Py_None || lz->func == (PyObject *)&PyBool_Type) {
423 ok = PyObject_IsTrue(item);
424 } else {
425 PyObject *good;
426 good = PyObject_CallFunctionObjArgs(lz->func,
427 item, NULL);
428 if (good == NULL) {
429 Py_DECREF(item);
430 return NULL;
431 }
432 ok = PyObject_IsTrue(good);
433 Py_DECREF(good);
434 }
435 if (ok)
436 return item;
437 Py_DECREF(item);
438 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000439}
440
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000441PyDoc_STRVAR(filter_doc,
Georg Brandld11ae5d2008-05-16 13:27:32 +0000442"filter(function or None, iterable) --> filter object\n\
Guido van Rossumc1f779c2007-07-03 08:25:58 +0000443\n\
Georg Brandld11ae5d2008-05-16 13:27:32 +0000444Return an iterator yielding those items of iterable for which function(item)\n\
Raymond Hettinger17301e92008-03-13 00:19:26 +0000445is true. If function is None, return the items that are true.");
446
447PyTypeObject PyFilter_Type = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000448 PyVarObject_HEAD_INIT(&PyType_Type, 0)
449 "filter", /* tp_name */
450 sizeof(filterobject), /* tp_basicsize */
451 0, /* tp_itemsize */
452 /* methods */
453 (destructor)filter_dealloc, /* tp_dealloc */
454 0, /* tp_print */
455 0, /* tp_getattr */
456 0, /* tp_setattr */
457 0, /* tp_reserved */
458 0, /* tp_repr */
459 0, /* tp_as_number */
460 0, /* tp_as_sequence */
461 0, /* tp_as_mapping */
462 0, /* tp_hash */
463 0, /* tp_call */
464 0, /* tp_str */
465 PyObject_GenericGetAttr, /* tp_getattro */
466 0, /* tp_setattro */
467 0, /* tp_as_buffer */
468 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
469 Py_TPFLAGS_BASETYPE, /* tp_flags */
470 filter_doc, /* tp_doc */
471 (traverseproc)filter_traverse, /* tp_traverse */
472 0, /* tp_clear */
473 0, /* tp_richcompare */
474 0, /* tp_weaklistoffset */
475 PyObject_SelfIter, /* tp_iter */
476 (iternextfunc)filter_next, /* tp_iternext */
477 0, /* tp_methods */
478 0, /* tp_members */
479 0, /* tp_getset */
480 0, /* tp_base */
481 0, /* tp_dict */
482 0, /* tp_descr_get */
483 0, /* tp_descr_set */
484 0, /* tp_dictoffset */
485 0, /* tp_init */
486 PyType_GenericAlloc, /* tp_alloc */
487 filter_new, /* tp_new */
488 PyObject_GC_Del, /* tp_free */
Raymond Hettinger17301e92008-03-13 00:19:26 +0000489};
490
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000491
Eric Smith8c663262007-08-25 02:26:07 +0000492static PyObject *
493builtin_format(PyObject *self, PyObject *args)
494{
Christian Heimes94b7d3d2007-12-11 20:20:39 +0000495 PyObject *value;
Eric Smith8fd3eba2008-02-17 19:48:00 +0000496 PyObject *format_spec = NULL;
Eric Smith8c663262007-08-25 02:26:07 +0000497
Eric Smith8fd3eba2008-02-17 19:48:00 +0000498 if (!PyArg_ParseTuple(args, "O|U:format", &value, &format_spec))
Benjamin Petersona12d5c62012-01-03 16:47:22 -0600499 return NULL;
Eric Smith8c663262007-08-25 02:26:07 +0000500
Eric Smith8fd3eba2008-02-17 19:48:00 +0000501 return PyObject_Format(value, format_spec);
Eric Smith8c663262007-08-25 02:26:07 +0000502}
503
Eric Smith8c663262007-08-25 02:26:07 +0000504PyDoc_STRVAR(format_doc,
Eric Smith81936692007-08-31 01:14:01 +0000505"format(value[, format_spec]) -> string\n\
Eric Smith8c663262007-08-25 02:26:07 +0000506\n\
Eric Smith81936692007-08-31 01:14:01 +0000507Returns value.__format__(format_spec)\n\
508format_spec defaults to \"\"");
509
Guido van Rossum7fcf2242007-05-04 17:43:11 +0000510static PyObject *
Walter Dörwalde7efd592007-06-05 20:07:21 +0000511builtin_chr(PyObject *self, PyObject *args)
Guido van Rossum09095f32000-03-10 23:00:52 +0000512{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000513 int x;
Guido van Rossum09095f32000-03-10 23:00:52 +0000514
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000515 if (!PyArg_ParseTuple(args, "i:chr", &x))
516 return NULL;
Fredrik Lundh0dcf67e2001-06-26 20:01:56 +0000517
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000518 return PyUnicode_FromOrdinal(x);
Guido van Rossum09095f32000-03-10 23:00:52 +0000519}
520
Victor Stinner63ab8752011-11-22 03:31:20 +0100521PyDoc_STRVAR(chr_doc,
Guido van Rossum84fc66d2007-05-03 17:18:26 +0000522"chr(i) -> Unicode character\n\
Guido van Rossum09095f32000-03-10 23:00:52 +0000523\n\
Victor Stinner63ab8752011-11-22 03:31:20 +0100524Return a Unicode string of one character with ordinal i; 0 <= i <= 0x10ffff.");
Guido van Rossum09095f32000-03-10 23:00:52 +0000525
526
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000527static char *
Benjamin Petersonf5b52242009-03-02 23:31:26 +0000528source_as_string(PyObject *cmd, char *funcname, char *what, PyCompilerFlags *cf)
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000529{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000530 char *str;
531 Py_ssize_t size;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000532
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000533 if (PyUnicode_Check(cmd)) {
534 cf->cf_flags |= PyCF_IGNORE_COOKIE;
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200535 str = PyUnicode_AsUTF8AndSize(cmd, &size);
536 if (str == NULL)
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000537 return NULL;
538 }
539 else if (!PyObject_CheckReadBuffer(cmd)) {
540 PyErr_Format(PyExc_TypeError,
541 "%s() arg 1 must be a %s object",
542 funcname, what);
543 return NULL;
544 }
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200545 else if (PyObject_AsReadBuffer(cmd, (const void **)&str, &size) < 0) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000546 return NULL;
547 }
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200548
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000549 if (strlen(str) != size) {
550 PyErr_SetString(PyExc_TypeError,
551 "source code string cannot contain null bytes");
552 return NULL;
553 }
554 return str;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000555}
556
Guido van Rossum79f25d91997-04-29 20:08:16 +0000557static PyObject *
Guido van Rossumd8faa362007-04-27 19:54:29 +0000558builtin_compile(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum5b722181993-03-30 17:46:03 +0000559{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000560 char *str;
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000561 PyObject *filename_obj;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000562 char *filename;
563 char *startstr;
564 int mode = -1;
565 int dont_inherit = 0;
566 int supplied_flags = 0;
Georg Brandl8334fd92010-12-04 10:26:46 +0000567 int optimize = -1;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000568 int is_ast;
569 PyCompilerFlags cf;
570 PyObject *cmd;
571 static char *kwlist[] = {"source", "filename", "mode", "flags",
Georg Brandl8334fd92010-12-04 10:26:46 +0000572 "dont_inherit", "optimize", NULL};
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000573 int start[] = {Py_file_input, Py_eval_input, Py_single_input};
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000574 PyObject *result;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000575
Georg Brandl8334fd92010-12-04 10:26:46 +0000576 if (!PyArg_ParseTupleAndKeywords(args, kwds, "OO&s|iii:compile", kwlist,
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000577 &cmd,
578 PyUnicode_FSConverter, &filename_obj,
579 &startstr, &supplied_flags,
Georg Brandl8334fd92010-12-04 10:26:46 +0000580 &dont_inherit, &optimize))
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000581 return NULL;
Tim Peters6cd6a822001-08-17 22:11:27 +0000582
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000583 filename = PyBytes_AS_STRING(filename_obj);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000584 cf.cf_flags = supplied_flags | PyCF_SOURCE_IS_UTF8;
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000585
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000586 if (supplied_flags &
587 ~(PyCF_MASK | PyCF_MASK_OBSOLETE | PyCF_DONT_IMPLY_DEDENT | PyCF_ONLY_AST))
588 {
589 PyErr_SetString(PyExc_ValueError,
590 "compile(): unrecognised flags");
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000591 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000592 }
593 /* XXX Warn if (supplied_flags & PyCF_MASK_OBSOLETE) != 0? */
Tim Peters6cd6a822001-08-17 22:11:27 +0000594
Georg Brandl8334fd92010-12-04 10:26:46 +0000595 if (optimize < -1 || optimize > 2) {
596 PyErr_SetString(PyExc_ValueError,
597 "compile(): invalid optimize value");
598 goto error;
599 }
600
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000601 if (!dont_inherit) {
602 PyEval_MergeCompilerFlags(&cf);
603 }
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000604
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000605 if (strcmp(startstr, "exec") == 0)
606 mode = 0;
607 else if (strcmp(startstr, "eval") == 0)
608 mode = 1;
609 else if (strcmp(startstr, "single") == 0)
610 mode = 2;
611 else {
612 PyErr_SetString(PyExc_ValueError,
613 "compile() arg 3 must be 'exec', 'eval' or 'single'");
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000614 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000615 }
Neal Norwitzdb4115f2008-03-31 04:20:05 +0000616
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000617 is_ast = PyAST_Check(cmd);
618 if (is_ast == -1)
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000619 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000620 if (is_ast) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000621 if (supplied_flags & PyCF_ONLY_AST) {
622 Py_INCREF(cmd);
623 result = cmd;
624 }
625 else {
626 PyArena *arena;
627 mod_ty mod;
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000628
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000629 arena = PyArena_New();
630 mod = PyAST_obj2mod(cmd, arena, mode);
631 if (mod == NULL) {
632 PyArena_Free(arena);
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000633 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000634 }
Benjamin Peterson832bfe22011-08-09 16:15:04 -0500635 if (!PyAST_Validate(mod)) {
636 PyArena_Free(arena);
637 goto error;
638 }
Georg Brandl8334fd92010-12-04 10:26:46 +0000639 result = (PyObject*)PyAST_CompileEx(mod, filename,
640 &cf, optimize, arena);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000641 PyArena_Free(arena);
642 }
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000643 goto finally;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000644 }
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000645
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000646 str = source_as_string(cmd, "compile", "string, bytes, AST or code", &cf);
647 if (str == NULL)
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000648 goto error;
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000649
Georg Brandl8334fd92010-12-04 10:26:46 +0000650 result = Py_CompileStringExFlags(str, filename, start[mode], &cf, optimize);
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000651 goto finally;
652
653error:
654 result = NULL;
655finally:
656 Py_DECREF(filename_obj);
657 return result;
Guido van Rossum5b722181993-03-30 17:46:03 +0000658}
659
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000660PyDoc_STRVAR(compile_doc,
Tim Peters6cd6a822001-08-17 22:11:27 +0000661"compile(source, filename, mode[, flags[, dont_inherit]]) -> code object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000662\n\
663Compile the source string (a Python module, statement or expression)\n\
Georg Brandl7cae87c2006-09-06 06:51:57 +0000664into a code object that can be executed by exec() or eval().\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000665The filename will be used for run-time error messages.\n\
666The mode must be 'exec' to compile a module, 'single' to compile a\n\
Tim Peters6cd6a822001-08-17 22:11:27 +0000667single (interactive) statement, or 'eval' to compile an expression.\n\
668The flags argument, if present, controls which future statements influence\n\
669the compilation of the code.\n\
670The dont_inherit argument, if non-zero, stops the compilation inheriting\n\
671the effects of any future statements in effect in the code calling\n\
672compile; if absent or zero these statements do influence the compilation,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000673in addition to any features explicitly specified.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000674
Guido van Rossum79f25d91997-04-29 20:08:16 +0000675static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000676builtin_dir(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000677{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000678 PyObject *arg = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000679
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000680 if (!PyArg_UnpackTuple(args, "dir", 0, 1, &arg))
681 return NULL;
682 return PyObject_Dir(arg);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000683}
684
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000685PyDoc_STRVAR(dir_doc,
Tim Peters5d2b77c2001-09-03 05:47:38 +0000686"dir([object]) -> list of strings\n"
687"\n"
Georg Brandle32b4222007-03-10 22:13:27 +0000688"If called without an argument, return the names in the current scope.\n"
689"Else, return an alphabetized list of names comprising (some of) the attributes\n"
690"of the given object, and of attributes reachable from it.\n"
691"If the object supplies a method named __dir__, it will be used; otherwise\n"
692"the default dir() logic is used and returns:\n"
693" for a module object: the module's attributes.\n"
694" for a class object: its attributes, and recursively the attributes\n"
695" of its bases.\n"
Guido van Rossumd8faa362007-04-27 19:54:29 +0000696" for any other object: its attributes, its class's attributes, and\n"
Georg Brandle32b4222007-03-10 22:13:27 +0000697" recursively the attributes of its class's base classes.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000698
Guido van Rossum79f25d91997-04-29 20:08:16 +0000699static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000700builtin_divmod(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000701{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000702 PyObject *v, *w;
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000703
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000704 if (!PyArg_UnpackTuple(args, "divmod", 2, 2, &v, &w))
705 return NULL;
706 return PyNumber_Divmod(v, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000707}
708
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000709PyDoc_STRVAR(divmod_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000710"divmod(x, y) -> (div, mod)\n\
711\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000712Return the tuple ((x-x%y)/y, x%y). Invariant: div*y + mod == x.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000713
714
Guido van Rossum79f25d91997-04-29 20:08:16 +0000715static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000716builtin_eval(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000717{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000718 PyObject *cmd, *result, *tmp = NULL;
719 PyObject *globals = Py_None, *locals = Py_None;
720 char *str;
721 PyCompilerFlags cf;
Guido van Rossum590baa41993-11-30 13:40:46 +0000722
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000723 if (!PyArg_UnpackTuple(args, "eval", 1, 3, &cmd, &globals, &locals))
724 return NULL;
725 if (locals != Py_None && !PyMapping_Check(locals)) {
726 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
727 return NULL;
728 }
729 if (globals != Py_None && !PyDict_Check(globals)) {
730 PyErr_SetString(PyExc_TypeError, PyMapping_Check(globals) ?
731 "globals must be a real dict; try eval(expr, {}, mapping)"
732 : "globals must be a dict");
733 return NULL;
734 }
735 if (globals == Py_None) {
736 globals = PyEval_GetGlobals();
737 if (locals == Py_None)
738 locals = PyEval_GetLocals();
739 }
740 else if (locals == Py_None)
741 locals = globals;
Tim Peters9fa96be2001-08-17 23:04:59 +0000742
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000743 if (globals == NULL || locals == NULL) {
744 PyErr_SetString(PyExc_TypeError,
745 "eval must be given globals and locals "
746 "when called without a frame");
747 return NULL;
748 }
Georg Brandl77c85e62005-09-15 10:46:13 +0000749
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000750 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
751 if (PyDict_SetItemString(globals, "__builtins__",
752 PyEval_GetBuiltins()) != 0)
753 return NULL;
754 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000755
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000756 if (PyCode_Check(cmd)) {
757 if (PyCode_GetNumFree((PyCodeObject *)cmd) > 0) {
758 PyErr_SetString(PyExc_TypeError,
759 "code object passed to eval() may not contain free variables");
760 return NULL;
761 }
Martin v. Löwis4d0d4712010-12-03 20:14:31 +0000762 return PyEval_EvalCode(cmd, globals, locals);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000763 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000764
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000765 cf.cf_flags = PyCF_SOURCE_IS_UTF8;
766 str = source_as_string(cmd, "eval", "string, bytes or code", &cf);
767 if (str == NULL)
768 return NULL;
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000769
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000770 while (*str == ' ' || *str == '\t')
771 str++;
Tim Peters9fa96be2001-08-17 23:04:59 +0000772
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000773 (void)PyEval_MergeCompilerFlags(&cf);
774 result = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
775 Py_XDECREF(tmp);
776 return result;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000777}
778
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000779PyDoc_STRVAR(eval_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000780"eval(source[, globals[, locals]]) -> value\n\
781\n\
782Evaluate the source in the context of globals and locals.\n\
783The source may be a string representing a Python expression\n\
784or a code object as returned by compile().\n\
Thomas Wouters89f507f2006-12-13 04:49:30 +0000785The globals must be a dictionary and locals can be any mapping,\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000786defaulting to the current globals and locals.\n\
787If only globals is given, locals defaults to it.\n");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000788
Georg Brandl7cae87c2006-09-06 06:51:57 +0000789static PyObject *
790builtin_exec(PyObject *self, PyObject *args)
791{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000792 PyObject *v;
793 PyObject *prog, *globals = Py_None, *locals = Py_None;
Georg Brandl7cae87c2006-09-06 06:51:57 +0000794
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000795 if (!PyArg_UnpackTuple(args, "exec", 1, 3, &prog, &globals, &locals))
796 return NULL;
Georg Brandl2cabc562008-08-28 07:57:16 +0000797
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000798 if (globals == Py_None) {
799 globals = PyEval_GetGlobals();
800 if (locals == Py_None) {
801 locals = PyEval_GetLocals();
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000802 }
803 if (!globals || !locals) {
804 PyErr_SetString(PyExc_SystemError,
805 "globals and locals cannot be NULL");
806 return NULL;
807 }
808 }
809 else if (locals == Py_None)
810 locals = globals;
Georg Brandl7cae87c2006-09-06 06:51:57 +0000811
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000812 if (!PyDict_Check(globals)) {
813 PyErr_Format(PyExc_TypeError, "exec() arg 2 must be a dict, not %.100s",
814 globals->ob_type->tp_name);
815 return NULL;
816 }
817 if (!PyMapping_Check(locals)) {
818 PyErr_Format(PyExc_TypeError,
819 "arg 3 must be a mapping or None, not %.100s",
820 locals->ob_type->tp_name);
821 return NULL;
822 }
823 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
824 if (PyDict_SetItemString(globals, "__builtins__",
825 PyEval_GetBuiltins()) != 0)
826 return NULL;
827 }
828
829 if (PyCode_Check(prog)) {
830 if (PyCode_GetNumFree((PyCodeObject *)prog) > 0) {
831 PyErr_SetString(PyExc_TypeError,
832 "code object passed to exec() may not "
833 "contain free variables");
834 return NULL;
835 }
Martin v. Löwis4d0d4712010-12-03 20:14:31 +0000836 v = PyEval_EvalCode(prog, globals, locals);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000837 }
838 else {
839 char *str;
840 PyCompilerFlags cf;
841 cf.cf_flags = PyCF_SOURCE_IS_UTF8;
842 str = source_as_string(prog, "exec",
843 "string, bytes or code", &cf);
844 if (str == NULL)
845 return NULL;
846 if (PyEval_MergeCompilerFlags(&cf))
847 v = PyRun_StringFlags(str, Py_file_input, globals,
848 locals, &cf);
849 else
850 v = PyRun_String(str, Py_file_input, globals, locals);
851 }
852 if (v == NULL)
853 return NULL;
854 Py_DECREF(v);
855 Py_RETURN_NONE;
Georg Brandl7cae87c2006-09-06 06:51:57 +0000856}
857
858PyDoc_STRVAR(exec_doc,
859"exec(object[, globals[, locals]])\n\
860\n\
Mark Dickinson480e8e32009-12-19 21:19:35 +0000861Read and execute code from an object, which can be a string or a code\n\
Benjamin Peterson38090262009-01-04 15:30:39 +0000862object.\n\
Georg Brandl7cae87c2006-09-06 06:51:57 +0000863The globals and locals are dictionaries, defaulting to the current\n\
864globals and locals. If only globals is given, locals defaults to it.");
865
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000866
Guido van Rossum79f25d91997-04-29 20:08:16 +0000867static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000868builtin_getattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000869{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000870 PyObject *v, *result, *dflt = NULL;
871 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000872
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000873 if (!PyArg_UnpackTuple(args, "getattr", 2, 3, &v, &name, &dflt))
874 return NULL;
Martin v. Löwis5b222132007-06-10 09:51:05 +0000875
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000876 if (!PyUnicode_Check(name)) {
877 PyErr_SetString(PyExc_TypeError,
878 "getattr(): attribute name must be string");
879 return NULL;
880 }
881 result = PyObject_GetAttr(v, name);
882 if (result == NULL && dflt != NULL &&
883 PyErr_ExceptionMatches(PyExc_AttributeError))
884 {
885 PyErr_Clear();
886 Py_INCREF(dflt);
887 result = dflt;
888 }
889 return result;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000890}
891
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000892PyDoc_STRVAR(getattr_doc,
Guido van Rossum950ff291998-06-29 13:38:57 +0000893"getattr(object, name[, default]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000894\n\
Guido van Rossum950ff291998-06-29 13:38:57 +0000895Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
896When a default argument is given, it is returned when the attribute doesn't\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000897exist; without it, an exception is raised in that case.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000898
899
Guido van Rossum79f25d91997-04-29 20:08:16 +0000900static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000901builtin_globals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +0000902{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000903 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000904
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000905 d = PyEval_GetGlobals();
906 Py_XINCREF(d);
907 return d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000908}
909
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000910PyDoc_STRVAR(globals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000911"globals() -> dictionary\n\
912\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000913Return the dictionary containing the current scope's global variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000914
915
Guido van Rossum79f25d91997-04-29 20:08:16 +0000916static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000917builtin_hasattr(PyObject *self, PyObject *args)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000918{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000919 PyObject *v;
920 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000921
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000922 if (!PyArg_UnpackTuple(args, "hasattr", 2, 2, &v, &name))
923 return NULL;
924 if (!PyUnicode_Check(name)) {
925 PyErr_SetString(PyExc_TypeError,
926 "hasattr(): attribute name must be string");
927 return NULL;
928 }
929 v = PyObject_GetAttr(v, name);
930 if (v == NULL) {
Benjamin Peterson17689992010-08-24 03:26:23 +0000931 if (PyErr_ExceptionMatches(PyExc_AttributeError)) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000932 PyErr_Clear();
Benjamin Peterson17689992010-08-24 03:26:23 +0000933 Py_RETURN_FALSE;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000934 }
Benjamin Peterson17689992010-08-24 03:26:23 +0000935 return NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000936 }
937 Py_DECREF(v);
Benjamin Peterson17689992010-08-24 03:26:23 +0000938 Py_RETURN_TRUE;
Guido van Rossum33894be1992-01-27 16:53:09 +0000939}
940
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000941PyDoc_STRVAR(hasattr_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000942"hasattr(object, name) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000943\n\
944Return whether the object has an attribute with the given name.\n\
Benjamin Peterson17689992010-08-24 03:26:23 +0000945(This is done by calling getattr(object, name) and catching AttributeError.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000946
947
Guido van Rossum79f25d91997-04-29 20:08:16 +0000948static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000949builtin_id(PyObject *self, PyObject *v)
Guido van Rossum5b722181993-03-30 17:46:03 +0000950{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000951 return PyLong_FromVoidPtr(v);
Guido van Rossum5b722181993-03-30 17:46:03 +0000952}
953
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000954PyDoc_STRVAR(id_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000955"id(object) -> integer\n\
956\n\
957Return the identity of an object. This is guaranteed to be unique among\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000958simultaneously existing objects. (Hint: it's the object's memory address.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000959
960
Raymond Hettingera6c60372008-03-13 01:26:19 +0000961/* map object ************************************************************/
962
963typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000964 PyObject_HEAD
965 PyObject *iters;
966 PyObject *func;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000967} mapobject;
968
Guido van Rossum79f25d91997-04-29 20:08:16 +0000969static PyObject *
Raymond Hettingera6c60372008-03-13 01:26:19 +0000970map_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000971{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000972 PyObject *it, *iters, *func;
973 mapobject *lz;
974 Py_ssize_t numargs, i;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000975
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000976 if (type == &PyMap_Type && !_PyArg_NoKeywords("map()", kwds))
977 return NULL;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000978
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000979 numargs = PyTuple_Size(args);
980 if (numargs < 2) {
981 PyErr_SetString(PyExc_TypeError,
982 "map() must have at least two arguments.");
983 return NULL;
984 }
Raymond Hettingera6c60372008-03-13 01:26:19 +0000985
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000986 iters = PyTuple_New(numargs-1);
987 if (iters == NULL)
988 return NULL;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000989
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000990 for (i=1 ; i<numargs ; i++) {
991 /* Get iterator. */
992 it = PyObject_GetIter(PyTuple_GET_ITEM(args, i));
993 if (it == NULL) {
994 Py_DECREF(iters);
995 return NULL;
996 }
997 PyTuple_SET_ITEM(iters, i-1, it);
998 }
Raymond Hettingera6c60372008-03-13 01:26:19 +0000999
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001000 /* create mapobject structure */
1001 lz = (mapobject *)type->tp_alloc(type, 0);
1002 if (lz == NULL) {
1003 Py_DECREF(iters);
1004 return NULL;
1005 }
1006 lz->iters = iters;
1007 func = PyTuple_GET_ITEM(args, 0);
1008 Py_INCREF(func);
1009 lz->func = func;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001010
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001011 return (PyObject *)lz;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001012}
1013
1014static void
1015map_dealloc(mapobject *lz)
1016{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001017 PyObject_GC_UnTrack(lz);
1018 Py_XDECREF(lz->iters);
1019 Py_XDECREF(lz->func);
1020 Py_TYPE(lz)->tp_free(lz);
Raymond Hettingera6c60372008-03-13 01:26:19 +00001021}
1022
1023static int
1024map_traverse(mapobject *lz, visitproc visit, void *arg)
1025{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001026 Py_VISIT(lz->iters);
1027 Py_VISIT(lz->func);
1028 return 0;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001029}
1030
1031static PyObject *
1032map_next(mapobject *lz)
1033{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001034 PyObject *val;
1035 PyObject *argtuple;
1036 PyObject *result;
1037 Py_ssize_t numargs, i;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001038
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001039 numargs = PyTuple_Size(lz->iters);
1040 argtuple = PyTuple_New(numargs);
1041 if (argtuple == NULL)
1042 return NULL;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001043
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001044 for (i=0 ; i<numargs ; i++) {
1045 val = PyIter_Next(PyTuple_GET_ITEM(lz->iters, i));
1046 if (val == NULL) {
1047 Py_DECREF(argtuple);
1048 return NULL;
1049 }
1050 PyTuple_SET_ITEM(argtuple, i, val);
1051 }
1052 result = PyObject_Call(lz->func, argtuple, NULL);
1053 Py_DECREF(argtuple);
1054 return result;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001055}
1056
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001057PyDoc_STRVAR(map_doc,
Raymond Hettingera6c60372008-03-13 01:26:19 +00001058"map(func, *iterables) --> map object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001059\n\
Raymond Hettingera6c60372008-03-13 01:26:19 +00001060Make an iterator that computes the function using arguments from\n\
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001061each of the iterables. Stops when the shortest iterable is exhausted.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001062
Raymond Hettingera6c60372008-03-13 01:26:19 +00001063PyTypeObject PyMap_Type = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001064 PyVarObject_HEAD_INIT(&PyType_Type, 0)
1065 "map", /* tp_name */
1066 sizeof(mapobject), /* tp_basicsize */
1067 0, /* tp_itemsize */
1068 /* methods */
1069 (destructor)map_dealloc, /* tp_dealloc */
1070 0, /* tp_print */
1071 0, /* tp_getattr */
1072 0, /* tp_setattr */
1073 0, /* tp_reserved */
1074 0, /* tp_repr */
1075 0, /* tp_as_number */
1076 0, /* tp_as_sequence */
1077 0, /* tp_as_mapping */
1078 0, /* tp_hash */
1079 0, /* tp_call */
1080 0, /* tp_str */
1081 PyObject_GenericGetAttr, /* tp_getattro */
1082 0, /* tp_setattro */
1083 0, /* tp_as_buffer */
1084 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
1085 Py_TPFLAGS_BASETYPE, /* tp_flags */
1086 map_doc, /* tp_doc */
1087 (traverseproc)map_traverse, /* tp_traverse */
1088 0, /* tp_clear */
1089 0, /* tp_richcompare */
1090 0, /* tp_weaklistoffset */
1091 PyObject_SelfIter, /* tp_iter */
1092 (iternextfunc)map_next, /* tp_iternext */
1093 0, /* tp_methods */
1094 0, /* tp_members */
1095 0, /* tp_getset */
1096 0, /* tp_base */
1097 0, /* tp_dict */
1098 0, /* tp_descr_get */
1099 0, /* tp_descr_set */
1100 0, /* tp_dictoffset */
1101 0, /* tp_init */
1102 PyType_GenericAlloc, /* tp_alloc */
1103 map_new, /* tp_new */
1104 PyObject_GC_Del, /* tp_free */
Raymond Hettingera6c60372008-03-13 01:26:19 +00001105};
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001106
Guido van Rossum79f25d91997-04-29 20:08:16 +00001107static PyObject *
Georg Brandla18af4e2007-04-21 15:47:16 +00001108builtin_next(PyObject *self, PyObject *args)
1109{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001110 PyObject *it, *res;
1111 PyObject *def = NULL;
Georg Brandla18af4e2007-04-21 15:47:16 +00001112
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001113 if (!PyArg_UnpackTuple(args, "next", 1, 2, &it, &def))
1114 return NULL;
1115 if (!PyIter_Check(it)) {
1116 PyErr_Format(PyExc_TypeError,
Philip Jenvey50add042011-11-06 16:37:52 -08001117 "'%.200s' object is not an iterator",
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001118 it->ob_type->tp_name);
1119 return NULL;
1120 }
1121
1122 res = (*it->ob_type->tp_iternext)(it);
1123 if (res != NULL) {
1124 return res;
1125 } else if (def != NULL) {
1126 if (PyErr_Occurred()) {
1127 if(!PyErr_ExceptionMatches(PyExc_StopIteration))
1128 return NULL;
1129 PyErr_Clear();
1130 }
1131 Py_INCREF(def);
1132 return def;
1133 } else if (PyErr_Occurred()) {
1134 return NULL;
1135 } else {
1136 PyErr_SetNone(PyExc_StopIteration);
1137 return NULL;
1138 }
Georg Brandla18af4e2007-04-21 15:47:16 +00001139}
1140
1141PyDoc_STRVAR(next_doc,
1142"next(iterator[, default])\n\
1143\n\
1144Return the next item from the iterator. If default is given and the iterator\n\
1145is exhausted, it is returned instead of raising StopIteration.");
1146
1147
1148static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001149builtin_setattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +00001150{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001151 PyObject *v;
1152 PyObject *name;
1153 PyObject *value;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001154
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001155 if (!PyArg_UnpackTuple(args, "setattr", 3, 3, &v, &name, &value))
1156 return NULL;
1157 if (PyObject_SetAttr(v, name, value) != 0)
1158 return NULL;
1159 Py_INCREF(Py_None);
1160 return Py_None;
Guido van Rossum33894be1992-01-27 16:53:09 +00001161}
1162
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001163PyDoc_STRVAR(setattr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001164"setattr(object, name, value)\n\
1165\n\
1166Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001167``x.y = v''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001168
1169
Guido van Rossum79f25d91997-04-29 20:08:16 +00001170static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001171builtin_delattr(PyObject *self, PyObject *args)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001172{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001173 PyObject *v;
1174 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001175
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001176 if (!PyArg_UnpackTuple(args, "delattr", 2, 2, &v, &name))
1177 return NULL;
1178 if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
1179 return NULL;
1180 Py_INCREF(Py_None);
1181 return Py_None;
Guido van Rossum14144fc1994-08-29 12:53:40 +00001182}
1183
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001184PyDoc_STRVAR(delattr_doc,
Guido van Rossumdf12a591998-11-23 22:13:04 +00001185"delattr(object, name)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001186\n\
1187Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001188``del x.y''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001189
1190
Guido van Rossum79f25d91997-04-29 20:08:16 +00001191static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001192builtin_hash(PyObject *self, PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00001193{
Benjamin Peterson8f67d082010-10-17 20:54:53 +00001194 Py_hash_t x;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001195
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001196 x = PyObject_Hash(v);
1197 if (x == -1)
1198 return NULL;
Benjamin Peterson8f67d082010-10-17 20:54:53 +00001199 return PyLong_FromSsize_t(x);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001200}
1201
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001202PyDoc_STRVAR(hash_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001203"hash(object) -> integer\n\
1204\n\
1205Return a hash value for the object. Two objects with the same value have\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001206the same hash value. The reverse is not necessarily true, but likely.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001207
1208
Guido van Rossum79f25d91997-04-29 20:08:16 +00001209static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001210builtin_hex(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001211{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001212 return PyNumber_ToBase(v, 16);
Guido van Rossum006bcd41991-10-24 14:54:44 +00001213}
1214
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001215PyDoc_STRVAR(hex_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001216"hex(number) -> string\n\
1217\n\
Alexander Belopolsky12338ab2011-04-07 00:15:33 -04001218Return the hexadecimal representation of an integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001219
1220
Guido van Rossum79f25d91997-04-29 20:08:16 +00001221static PyObject *
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001222builtin_iter(PyObject *self, PyObject *args)
1223{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001224 PyObject *v, *w = NULL;
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001225
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001226 if (!PyArg_UnpackTuple(args, "iter", 1, 2, &v, &w))
1227 return NULL;
1228 if (w == NULL)
1229 return PyObject_GetIter(v);
1230 if (!PyCallable_Check(v)) {
1231 PyErr_SetString(PyExc_TypeError,
1232 "iter(v, w): v must be callable");
1233 return NULL;
1234 }
1235 return PyCallIter_New(v, w);
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001236}
1237
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001238PyDoc_STRVAR(iter_doc,
Georg Brandld11ae5d2008-05-16 13:27:32 +00001239"iter(iterable) -> iterator\n\
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001240iter(callable, sentinel) -> iterator\n\
1241\n\
1242Get an iterator from an object. In the first form, the argument must\n\
1243supply its own iterator, or be a sequence.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001244In the second form, the callable is called until it returns the sentinel.");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001245
1246
1247static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001248builtin_len(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001249{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001250 Py_ssize_t res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001251
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001252 res = PyObject_Size(v);
1253 if (res < 0 && PyErr_Occurred())
1254 return NULL;
1255 return PyLong_FromSsize_t(res);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001256}
1257
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001258PyDoc_STRVAR(len_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001259"len(object) -> integer\n\
1260\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001261Return the number of items of a sequence or mapping.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001262
1263
Guido van Rossum79f25d91997-04-29 20:08:16 +00001264static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001265builtin_locals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +00001266{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001267 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001268
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001269 d = PyEval_GetLocals();
1270 Py_XINCREF(d);
1271 return d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001272}
1273
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001274PyDoc_STRVAR(locals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001275"locals() -> dictionary\n\
1276\n\
Raymond Hettinger69bf8f32003-01-04 02:16:22 +00001277Update and return a dictionary containing the current scope's local variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001278
1279
Guido van Rossum79f25d91997-04-29 20:08:16 +00001280static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001281min_max(PyObject *args, PyObject *kwds, int op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001282{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001283 PyObject *v, *it, *item, *val, *maxitem, *maxval, *keyfunc=NULL;
1284 const char *name = op == Py_LT ? "min" : "max";
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001285
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001286 if (PyTuple_Size(args) > 1)
1287 v = args;
1288 else if (!PyArg_UnpackTuple(args, (char *)name, 1, 1, &v))
1289 return NULL;
Tim Peters67d687a2002-04-29 21:27:32 +00001290
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001291 if (kwds != NULL && PyDict_Check(kwds) && PyDict_Size(kwds)) {
1292 keyfunc = PyDict_GetItemString(kwds, "key");
1293 if (PyDict_Size(kwds)!=1 || keyfunc == NULL) {
1294 PyErr_Format(PyExc_TypeError,
1295 "%s() got an unexpected keyword argument", name);
1296 return NULL;
1297 }
1298 Py_INCREF(keyfunc);
1299 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001300
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001301 it = PyObject_GetIter(v);
1302 if (it == NULL) {
1303 Py_XDECREF(keyfunc);
1304 return NULL;
1305 }
Tim Petersc3074532001-05-03 07:00:32 +00001306
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001307 maxitem = NULL; /* the result */
1308 maxval = NULL; /* the value associated with the result */
1309 while (( item = PyIter_Next(it) )) {
1310 /* get the value from the key function */
1311 if (keyfunc != NULL) {
1312 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1313 if (val == NULL)
1314 goto Fail_it_item;
1315 }
1316 /* no key function; the value is the item */
1317 else {
1318 val = item;
1319 Py_INCREF(val);
1320 }
Tim Petersc3074532001-05-03 07:00:32 +00001321
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001322 /* maximum value and item are unset; set them */
1323 if (maxval == NULL) {
1324 maxitem = item;
1325 maxval = val;
1326 }
1327 /* maximum value and item are set; update them as necessary */
1328 else {
1329 int cmp = PyObject_RichCompareBool(val, maxval, op);
1330 if (cmp < 0)
1331 goto Fail_it_item_and_val;
1332 else if (cmp > 0) {
1333 Py_DECREF(maxval);
1334 Py_DECREF(maxitem);
1335 maxval = val;
1336 maxitem = item;
1337 }
1338 else {
1339 Py_DECREF(item);
1340 Py_DECREF(val);
1341 }
1342 }
1343 }
1344 if (PyErr_Occurred())
1345 goto Fail_it;
1346 if (maxval == NULL) {
1347 PyErr_Format(PyExc_ValueError,
1348 "%s() arg is an empty sequence", name);
1349 assert(maxitem == NULL);
1350 }
1351 else
1352 Py_DECREF(maxval);
1353 Py_DECREF(it);
1354 Py_XDECREF(keyfunc);
1355 return maxitem;
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001356
1357Fail_it_item_and_val:
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001358 Py_DECREF(val);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001359Fail_it_item:
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001360 Py_DECREF(item);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001361Fail_it:
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001362 Py_XDECREF(maxval);
1363 Py_XDECREF(maxitem);
1364 Py_DECREF(it);
1365 Py_XDECREF(keyfunc);
1366 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001367}
1368
Guido van Rossum79f25d91997-04-29 20:08:16 +00001369static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001370builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001371{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001372 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001373}
1374
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001375PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001376"min(iterable[, key=func]) -> value\n\
1377min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001378\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001379With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001380With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001381
1382
Guido van Rossum79f25d91997-04-29 20:08:16 +00001383static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001384builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001385{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001386 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001387}
1388
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001389PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001390"max(iterable[, key=func]) -> value\n\
1391max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001392\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001393With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001394With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001395
1396
Guido van Rossum79f25d91997-04-29 20:08:16 +00001397static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001398builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001399{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001400 return PyNumber_ToBase(v, 8);
Guido van Rossum006bcd41991-10-24 14:54:44 +00001401}
1402
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001403PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001404"oct(number) -> string\n\
1405\n\
Alexander Belopolsky12338ab2011-04-07 00:15:33 -04001406Return the octal representation of an integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001407
1408
Guido van Rossum79f25d91997-04-29 20:08:16 +00001409static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001410builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001411{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001412 long ord;
1413 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001414
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001415 if (PyBytes_Check(obj)) {
1416 size = PyBytes_GET_SIZE(obj);
1417 if (size == 1) {
1418 ord = (long)((unsigned char)*PyBytes_AS_STRING(obj));
1419 return PyLong_FromLong(ord);
1420 }
1421 }
1422 else if (PyUnicode_Check(obj)) {
Martin v. Löwisd63a3b82011-09-28 07:41:54 +02001423 if (PyUnicode_READY(obj) == -1)
1424 return NULL;
1425 size = PyUnicode_GET_LENGTH(obj);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001426 if (size == 1) {
Martin v. Löwisd63a3b82011-09-28 07:41:54 +02001427 ord = (long)PyUnicode_READ_CHAR(obj, 0);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001428 return PyLong_FromLong(ord);
1429 }
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001430 }
1431 else if (PyByteArray_Check(obj)) {
1432 /* XXX Hopefully this is temporary */
1433 size = PyByteArray_GET_SIZE(obj);
1434 if (size == 1) {
1435 ord = (long)((unsigned char)*PyByteArray_AS_STRING(obj));
1436 return PyLong_FromLong(ord);
1437 }
1438 }
1439 else {
1440 PyErr_Format(PyExc_TypeError,
1441 "ord() expected string of length 1, but " \
1442 "%.200s found", obj->ob_type->tp_name);
1443 return NULL;
1444 }
Guido van Rossum09095f32000-03-10 23:00:52 +00001445
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001446 PyErr_Format(PyExc_TypeError,
1447 "ord() expected a character, "
1448 "but string of length %zd found",
1449 size);
1450 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001451}
1452
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001453PyDoc_VAR(ord_doc) = PyDoc_STR(
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001454"ord(c) -> integer\n\
1455\n\
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001456Return the integer ordinal of a one-character string."
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001457)
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001458#ifndef Py_UNICODE_WIDE
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001459PyDoc_STR(
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001460"\nA valid surrogate pair is also accepted."
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001461)
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001462#endif
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001463;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001464
1465
Guido van Rossum79f25d91997-04-29 20:08:16 +00001466static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001467builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001468{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001469 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001470
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001471 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
1472 return NULL;
1473 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001474}
1475
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001476PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001477"pow(x, y[, z]) -> number\n\
1478\n\
1479With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001480equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001481
1482
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001483
Guido van Rossum34343512006-11-30 22:13:52 +00001484static PyObject *
1485builtin_print(PyObject *self, PyObject *args, PyObject *kwds)
1486{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001487 static char *kwlist[] = {"sep", "end", "file", 0};
1488 static PyObject *dummy_args;
1489 PyObject *sep = NULL, *end = NULL, *file = NULL;
1490 int i, err;
Guido van Rossum34343512006-11-30 22:13:52 +00001491
Benjamin Peterson00102562012-01-11 21:00:16 -05001492 if (dummy_args == NULL && !(dummy_args = PyTuple_New(0)))
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001493 return NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001494 if (!PyArg_ParseTupleAndKeywords(dummy_args, kwds, "|OOO:print",
1495 kwlist, &sep, &end, &file))
1496 return NULL;
1497 if (file == NULL || file == Py_None) {
1498 file = PySys_GetObject("stdout");
1499 /* sys.stdout may be None when FILE* stdout isn't connected */
1500 if (file == Py_None)
1501 Py_RETURN_NONE;
1502 }
Guido van Rossum34343512006-11-30 22:13:52 +00001503
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001504 if (sep == Py_None) {
1505 sep = NULL;
1506 }
1507 else if (sep && !PyUnicode_Check(sep)) {
1508 PyErr_Format(PyExc_TypeError,
1509 "sep must be None or a string, not %.200s",
1510 sep->ob_type->tp_name);
1511 return NULL;
1512 }
1513 if (end == Py_None) {
1514 end = NULL;
1515 }
1516 else if (end && !PyUnicode_Check(end)) {
1517 PyErr_Format(PyExc_TypeError,
1518 "end must be None or a string, not %.200s",
1519 end->ob_type->tp_name);
1520 return NULL;
1521 }
Guido van Rossum34343512006-11-30 22:13:52 +00001522
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001523 for (i = 0; i < PyTuple_Size(args); i++) {
1524 if (i > 0) {
1525 if (sep == NULL)
1526 err = PyFile_WriteString(" ", file);
1527 else
1528 err = PyFile_WriteObject(sep, file,
1529 Py_PRINT_RAW);
1530 if (err)
1531 return NULL;
1532 }
1533 err = PyFile_WriteObject(PyTuple_GetItem(args, i), file,
1534 Py_PRINT_RAW);
1535 if (err)
1536 return NULL;
1537 }
Guido van Rossum34343512006-11-30 22:13:52 +00001538
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001539 if (end == NULL)
1540 err = PyFile_WriteString("\n", file);
1541 else
1542 err = PyFile_WriteObject(end, file, Py_PRINT_RAW);
1543 if (err)
1544 return NULL;
Guido van Rossum34343512006-11-30 22:13:52 +00001545
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001546 Py_RETURN_NONE;
Guido van Rossum34343512006-11-30 22:13:52 +00001547}
1548
1549PyDoc_STRVAR(print_doc,
Georg Brandlcd5da7d2008-02-01 15:47:37 +00001550"print(value, ..., sep=' ', end='\\n', file=sys.stdout)\n\
Guido van Rossum34343512006-11-30 22:13:52 +00001551\n\
1552Prints the values to a stream, or to sys.stdout by default.\n\
1553Optional keyword arguments:\n\
1554file: a file-like object (stream); defaults to the current sys.stdout.\n\
1555sep: string inserted between values, default a space.\n\
1556end: string appended after the last value, default a newline.");
1557
1558
Guido van Rossuma88a0332007-02-26 16:59:55 +00001559static PyObject *
1560builtin_input(PyObject *self, PyObject *args)
1561{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001562 PyObject *promptarg = NULL;
1563 PyObject *fin = PySys_GetObject("stdin");
1564 PyObject *fout = PySys_GetObject("stdout");
1565 PyObject *ferr = PySys_GetObject("stderr");
1566 PyObject *tmp;
1567 long fd;
1568 int tty;
Guido van Rossuma88a0332007-02-26 16:59:55 +00001569
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001570 /* Parse arguments */
1571 if (!PyArg_UnpackTuple(args, "input", 0, 1, &promptarg))
1572 return NULL;
Guido van Rossuma88a0332007-02-26 16:59:55 +00001573
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001574 /* Check that stdin/out/err are intact */
1575 if (fin == NULL || fin == Py_None) {
1576 PyErr_SetString(PyExc_RuntimeError,
1577 "input(): lost sys.stdin");
1578 return NULL;
1579 }
1580 if (fout == NULL || fout == Py_None) {
1581 PyErr_SetString(PyExc_RuntimeError,
1582 "input(): lost sys.stdout");
1583 return NULL;
1584 }
1585 if (ferr == NULL || ferr == Py_None) {
1586 PyErr_SetString(PyExc_RuntimeError,
1587 "input(): lost sys.stderr");
1588 return NULL;
1589 }
Guido van Rossumeba76962007-05-27 09:13:28 +00001590
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001591 /* First of all, flush stderr */
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001592 tmp = _PyObject_CallMethodId(ferr, &PyId_flush, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001593 if (tmp == NULL)
1594 PyErr_Clear();
1595 else
1596 Py_DECREF(tmp);
Guido van Rossumeba76962007-05-27 09:13:28 +00001597
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001598 /* We should only use (GNU) readline if Python's sys.stdin and
1599 sys.stdout are the same as C's stdin and stdout, because we
1600 need to pass it those. */
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001601 tmp = _PyObject_CallMethodId(fin, &PyId_fileno, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001602 if (tmp == NULL) {
1603 PyErr_Clear();
1604 tty = 0;
1605 }
1606 else {
1607 fd = PyLong_AsLong(tmp);
1608 Py_DECREF(tmp);
1609 if (fd < 0 && PyErr_Occurred())
1610 return NULL;
1611 tty = fd == fileno(stdin) && isatty(fd);
1612 }
1613 if (tty) {
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001614 tmp = _PyObject_CallMethodId(fout, &PyId_fileno, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001615 if (tmp == NULL)
1616 PyErr_Clear();
1617 else {
1618 fd = PyLong_AsLong(tmp);
1619 Py_DECREF(tmp);
1620 if (fd < 0 && PyErr_Occurred())
1621 return NULL;
1622 tty = fd == fileno(stdout) && isatty(fd);
1623 }
1624 }
Guido van Rossumeba76962007-05-27 09:13:28 +00001625
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001626 /* If we're interactive, use (GNU) readline */
1627 if (tty) {
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001628 PyObject *po = NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001629 char *prompt;
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001630 char *s = NULL;
1631 PyObject *stdin_encoding = NULL, *stdin_errors = NULL;
1632 PyObject *stdout_encoding = NULL, *stdout_errors = NULL;
1633 char *stdin_encoding_str, *stdin_errors_str;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001634 PyObject *result;
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001635 size_t len;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +02001636 _Py_IDENTIFIER(encoding);
Antoine Pitrou5ee9d8a2011-11-06 00:38:45 +01001637 _Py_IDENTIFIER(errors);
Martin v. Löwis4a7b5d52007-09-04 05:24:49 +00001638
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001639 stdin_encoding = _PyObject_GetAttrId(fin, &PyId_encoding);
Antoine Pitrou5ee9d8a2011-11-06 00:38:45 +01001640 stdin_errors = _PyObject_GetAttrId(fin, &PyId_errors);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001641 if (!stdin_encoding || !stdin_errors)
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001642 /* stdin is a text stream, so it must have an
1643 encoding. */
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001644 goto _readline_errors;
Victor Stinner306f0102010-05-19 01:06:22 +00001645 stdin_encoding_str = _PyUnicode_AsString(stdin_encoding);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001646 stdin_errors_str = _PyUnicode_AsString(stdin_errors);
1647 if (!stdin_encoding_str || !stdin_errors_str)
1648 goto _readline_errors;
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001649 tmp = _PyObject_CallMethodId(fout, &PyId_flush, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001650 if (tmp == NULL)
1651 PyErr_Clear();
1652 else
1653 Py_DECREF(tmp);
1654 if (promptarg != NULL) {
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001655 /* We have a prompt, encode it as stdout would */
1656 char *stdout_encoding_str, *stdout_errors_str;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001657 PyObject *stringpo;
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001658 stdout_encoding = _PyObject_GetAttrId(fout, &PyId_encoding);
Antoine Pitrou5ee9d8a2011-11-06 00:38:45 +01001659 stdout_errors = _PyObject_GetAttrId(fout, &PyId_errors);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001660 if (!stdout_encoding || !stdout_errors)
1661 goto _readline_errors;
Victor Stinner306f0102010-05-19 01:06:22 +00001662 stdout_encoding_str = _PyUnicode_AsString(stdout_encoding);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001663 stdout_errors_str = _PyUnicode_AsString(stdout_errors);
1664 if (!stdout_encoding_str || !stdout_errors_str)
1665 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001666 stringpo = PyObject_Str(promptarg);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001667 if (stringpo == NULL)
1668 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001669 po = PyUnicode_AsEncodedString(stringpo,
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001670 stdout_encoding_str, stdout_errors_str);
1671 Py_CLEAR(stdout_encoding);
1672 Py_CLEAR(stdout_errors);
1673 Py_CLEAR(stringpo);
1674 if (po == NULL)
1675 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001676 prompt = PyBytes_AsString(po);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001677 if (prompt == NULL)
1678 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001679 }
1680 else {
1681 po = NULL;
1682 prompt = "";
1683 }
1684 s = PyOS_Readline(stdin, stdout, prompt);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001685 if (s == NULL) {
1686 if (!PyErr_Occurred())
1687 PyErr_SetNone(PyExc_KeyboardInterrupt);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001688 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001689 }
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001690
1691 len = strlen(s);
1692 if (len == 0) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001693 PyErr_SetNone(PyExc_EOFError);
1694 result = NULL;
1695 }
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001696 else {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001697 if (len > PY_SSIZE_T_MAX) {
1698 PyErr_SetString(PyExc_OverflowError,
1699 "input: input too long");
1700 result = NULL;
1701 }
1702 else {
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001703 len--; /* strip trailing '\n' */
1704 if (len != 0 && s[len-1] == '\r')
1705 len--; /* strip trailing '\r' */
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001706 result = PyUnicode_Decode(s, len, stdin_encoding_str,
1707 stdin_errors_str);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001708 }
1709 }
1710 Py_DECREF(stdin_encoding);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001711 Py_DECREF(stdin_errors);
1712 Py_XDECREF(po);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001713 PyMem_FREE(s);
1714 return result;
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001715 _readline_errors:
1716 Py_XDECREF(stdin_encoding);
1717 Py_XDECREF(stdout_encoding);
1718 Py_XDECREF(stdin_errors);
1719 Py_XDECREF(stdout_errors);
1720 Py_XDECREF(po);
1721 return NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001722 }
Guido van Rossumeba76962007-05-27 09:13:28 +00001723
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001724 /* Fallback if we're not interactive */
1725 if (promptarg != NULL) {
1726 if (PyFile_WriteObject(promptarg, fout, Py_PRINT_RAW) != 0)
1727 return NULL;
1728 }
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001729 tmp = _PyObject_CallMethodId(fout, &PyId_flush, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001730 if (tmp == NULL)
1731 PyErr_Clear();
1732 else
1733 Py_DECREF(tmp);
1734 return PyFile_GetLine(fin, -1);
Guido van Rossuma88a0332007-02-26 16:59:55 +00001735}
1736
1737PyDoc_STRVAR(input_doc,
1738"input([prompt]) -> string\n\
1739\n\
1740Read a string from standard input. The trailing newline is stripped.\n\
1741If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
1742On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
1743is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001744
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001745
Guido van Rossum79f25d91997-04-29 20:08:16 +00001746static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001747builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00001748{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001749 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00001750}
1751
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001752PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001753"repr(object) -> string\n\
1754\n\
1755Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001756For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001757
1758
Guido van Rossum79f25d91997-04-29 20:08:16 +00001759static PyObject *
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001760builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001761{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001762 static PyObject *round_str = NULL;
1763 PyObject *ndigits = NULL;
1764 static char *kwlist[] = {"number", "ndigits", 0};
1765 PyObject *number, *round;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001766
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001767 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:round",
1768 kwlist, &number, &ndigits))
1769 return NULL;
Alex Martelliae211f92007-08-22 23:21:33 +00001770
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001771 if (Py_TYPE(number)->tp_dict == NULL) {
1772 if (PyType_Ready(Py_TYPE(number)) < 0)
1773 return NULL;
1774 }
Guido van Rossum15d3d042007-08-24 02:02:45 +00001775
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001776 if (round_str == NULL) {
1777 round_str = PyUnicode_InternFromString("__round__");
1778 if (round_str == NULL)
1779 return NULL;
1780 }
Guido van Rossum2fa33db2007-08-23 22:07:24 +00001781
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001782 round = _PyType_Lookup(Py_TYPE(number), round_str);
1783 if (round == NULL) {
1784 PyErr_Format(PyExc_TypeError,
1785 "type %.100s doesn't define __round__ method",
1786 Py_TYPE(number)->tp_name);
1787 return NULL;
1788 }
Alex Martelliae211f92007-08-22 23:21:33 +00001789
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001790 if (ndigits == NULL)
1791 return PyObject_CallFunction(round, "O", number);
1792 else
1793 return PyObject_CallFunction(round, "OO", number, ndigits);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001794}
1795
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001796PyDoc_STRVAR(round_doc,
Mark Dickinson1124e712009-01-28 21:25:58 +00001797"round(number[, ndigits]) -> number\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001798\n\
1799Round a number to a given precision in decimal digits (default 0 digits).\n\
Mark Dickinson0d748c22008-07-05 11:29:03 +00001800This returns an int when called with one argument, otherwise the\n\
Georg Brandl809ddaa2008-07-01 20:39:59 +00001801same type as the number. ndigits may be negative.");
Guido van Rossum2fa33db2007-08-23 22:07:24 +00001802
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001803
Raymond Hettinger64958a12003-12-17 20:43:33 +00001804static PyObject *
1805builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
1806{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001807 PyObject *newlist, *v, *seq, *keyfunc=NULL, *newargs;
1808 PyObject *callable;
1809 static char *kwlist[] = {"iterable", "key", "reverse", 0};
1810 int reverse;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +02001811 _Py_IDENTIFIER(sort);
Raymond Hettinger64958a12003-12-17 20:43:33 +00001812
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001813 /* args 1-3 should match listsort in Objects/listobject.c */
1814 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|Oi:sorted",
1815 kwlist, &seq, &keyfunc, &reverse))
1816 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001817
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001818 newlist = PySequence_List(seq);
1819 if (newlist == NULL)
1820 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001821
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001822 callable = _PyObject_GetAttrId(newlist, &PyId_sort);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001823 if (callable == NULL) {
1824 Py_DECREF(newlist);
1825 return NULL;
1826 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001827
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001828 newargs = PyTuple_GetSlice(args, 1, 4);
1829 if (newargs == NULL) {
1830 Py_DECREF(newlist);
1831 Py_DECREF(callable);
1832 return NULL;
1833 }
Raymond Hettinger64958a12003-12-17 20:43:33 +00001834
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001835 v = PyObject_Call(callable, newargs, kwds);
1836 Py_DECREF(newargs);
1837 Py_DECREF(callable);
1838 if (v == NULL) {
1839 Py_DECREF(newlist);
1840 return NULL;
1841 }
1842 Py_DECREF(v);
1843 return newlist;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001844}
1845
1846PyDoc_STRVAR(sorted_doc,
Raymond Hettinger70b64fc2008-01-30 20:15:17 +00001847"sorted(iterable, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001848
Guido van Rossum79f25d91997-04-29 20:08:16 +00001849static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001850builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00001851{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001852 PyObject *v = NULL;
1853 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001854
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001855 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
1856 return NULL;
1857 if (v == NULL) {
1858 d = PyEval_GetLocals();
1859 if (d == NULL) {
1860 if (!PyErr_Occurred())
1861 PyErr_SetString(PyExc_SystemError,
1862 "vars(): no locals!?");
1863 }
1864 else
1865 Py_INCREF(d);
1866 }
1867 else {
Martin v. Löwisbd928fe2011-10-14 10:20:37 +02001868 _Py_IDENTIFIER(__dict__);
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001869 d = _PyObject_GetAttrId(v, &PyId___dict__);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001870 if (d == NULL) {
1871 PyErr_SetString(PyExc_TypeError,
1872 "vars() argument must have __dict__ attribute");
1873 return NULL;
1874 }
1875 }
1876 return d;
Guido van Rossum2d951851994-08-29 12:52:16 +00001877}
1878
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001879PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001880"vars([object]) -> dictionary\n\
1881\n\
1882Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001883With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001884
Alex Martellia70b1912003-04-22 08:12:33 +00001885static PyObject*
1886builtin_sum(PyObject *self, PyObject *args)
1887{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001888 PyObject *seq;
1889 PyObject *result = NULL;
1890 PyObject *temp, *item, *iter;
Alex Martellia70b1912003-04-22 08:12:33 +00001891
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001892 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
1893 return NULL;
Alex Martellia70b1912003-04-22 08:12:33 +00001894
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001895 iter = PyObject_GetIter(seq);
1896 if (iter == NULL)
1897 return NULL;
Alex Martellia70b1912003-04-22 08:12:33 +00001898
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001899 if (result == NULL) {
1900 result = PyLong_FromLong(0);
1901 if (result == NULL) {
1902 Py_DECREF(iter);
1903 return NULL;
1904 }
1905 } else {
1906 /* reject string values for 'start' parameter */
1907 if (PyUnicode_Check(result)) {
1908 PyErr_SetString(PyExc_TypeError,
1909 "sum() can't sum strings [use ''.join(seq) instead]");
1910 Py_DECREF(iter);
1911 return NULL;
1912 }
Benjamin Petersonce071ca2011-07-29 14:23:47 -05001913 if (PyBytes_Check(result)) {
1914 PyErr_SetString(PyExc_TypeError,
1915 "sum() can't sum bytes [use b''.join(seq) instead]");
Benjamin Peterson405f32c2011-07-29 22:43:45 -05001916 Py_DECREF(iter);
Benjamin Petersonce071ca2011-07-29 14:23:47 -05001917 return NULL;
1918 }
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001919 if (PyByteArray_Check(result)) {
1920 PyErr_SetString(PyExc_TypeError,
Benjamin Peterson4f921c22011-07-29 14:24:29 -05001921 "sum() can't sum bytearray [use b''.join(seq) instead]");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001922 Py_DECREF(iter);
1923 return NULL;
1924 }
Guido van Rossum3172c5d2007-10-16 18:12:55 +00001925
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001926 Py_INCREF(result);
1927 }
Alex Martellia70b1912003-04-22 08:12:33 +00001928
Guido van Rossum8ce8a782007-11-01 19:42:39 +00001929#ifndef SLOW_SUM
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001930 /* Fast addition by keeping temporary sums in C instead of new Python objects.
1931 Assumes all inputs are the same type. If the assumption fails, default
1932 to the more general routine.
1933 */
1934 if (PyLong_CheckExact(result)) {
1935 int overflow;
1936 long i_result = PyLong_AsLongAndOverflow(result, &overflow);
1937 /* If this already overflowed, don't even enter the loop. */
1938 if (overflow == 0) {
1939 Py_DECREF(result);
1940 result = NULL;
1941 }
1942 while(result == NULL) {
1943 item = PyIter_Next(iter);
1944 if (item == NULL) {
1945 Py_DECREF(iter);
1946 if (PyErr_Occurred())
1947 return NULL;
1948 return PyLong_FromLong(i_result);
1949 }
1950 if (PyLong_CheckExact(item)) {
1951 long b = PyLong_AsLongAndOverflow(item, &overflow);
1952 long x = i_result + b;
1953 if (overflow == 0 && ((x^i_result) >= 0 || (x^b) >= 0)) {
1954 i_result = x;
1955 Py_DECREF(item);
1956 continue;
1957 }
1958 }
1959 /* Either overflowed or is not an int. Restore real objects and process normally */
1960 result = PyLong_FromLong(i_result);
1961 temp = PyNumber_Add(result, item);
1962 Py_DECREF(result);
1963 Py_DECREF(item);
1964 result = temp;
1965 if (result == NULL) {
1966 Py_DECREF(iter);
1967 return NULL;
1968 }
1969 }
1970 }
Guido van Rossum8ce8a782007-11-01 19:42:39 +00001971
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001972 if (PyFloat_CheckExact(result)) {
1973 double f_result = PyFloat_AS_DOUBLE(result);
1974 Py_DECREF(result);
1975 result = NULL;
1976 while(result == NULL) {
1977 item = PyIter_Next(iter);
1978 if (item == NULL) {
1979 Py_DECREF(iter);
1980 if (PyErr_Occurred())
1981 return NULL;
1982 return PyFloat_FromDouble(f_result);
1983 }
1984 if (PyFloat_CheckExact(item)) {
1985 PyFPE_START_PROTECT("add", Py_DECREF(item); Py_DECREF(iter); return 0)
1986 f_result += PyFloat_AS_DOUBLE(item);
1987 PyFPE_END_PROTECT(f_result)
1988 Py_DECREF(item);
1989 continue;
1990 }
1991 if (PyLong_CheckExact(item)) {
1992 long value;
1993 int overflow;
1994 value = PyLong_AsLongAndOverflow(item, &overflow);
1995 if (!overflow) {
1996 PyFPE_START_PROTECT("add", Py_DECREF(item); Py_DECREF(iter); return 0)
1997 f_result += (double)value;
1998 PyFPE_END_PROTECT(f_result)
1999 Py_DECREF(item);
2000 continue;
2001 }
2002 }
2003 result = PyFloat_FromDouble(f_result);
2004 temp = PyNumber_Add(result, item);
2005 Py_DECREF(result);
2006 Py_DECREF(item);
2007 result = temp;
2008 if (result == NULL) {
2009 Py_DECREF(iter);
2010 return NULL;
2011 }
2012 }
2013 }
Guido van Rossum8ce8a782007-11-01 19:42:39 +00002014#endif
2015
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002016 for(;;) {
2017 item = PyIter_Next(iter);
2018 if (item == NULL) {
2019 /* error, or end-of-sequence */
2020 if (PyErr_Occurred()) {
2021 Py_DECREF(result);
2022 result = NULL;
2023 }
2024 break;
2025 }
2026 /* It's tempting to use PyNumber_InPlaceAdd instead of
2027 PyNumber_Add here, to avoid quadratic running time
2028 when doing 'sum(list_of_lists, [])'. However, this
2029 would produce a change in behaviour: a snippet like
Mark Dickinson9acadc52009-10-26 14:19:42 +00002030
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002031 empty = []
2032 sum([[x] for x in range(10)], empty)
Mark Dickinson9acadc52009-10-26 14:19:42 +00002033
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002034 would change the value of empty. */
2035 temp = PyNumber_Add(result, item);
2036 Py_DECREF(result);
2037 Py_DECREF(item);
2038 result = temp;
2039 if (result == NULL)
2040 break;
2041 }
2042 Py_DECREF(iter);
2043 return result;
Alex Martellia70b1912003-04-22 08:12:33 +00002044}
2045
2046PyDoc_STRVAR(sum_doc,
Georg Brandld11ae5d2008-05-16 13:27:32 +00002047"sum(iterable[, start]) -> value\n\
Alex Martellia70b1912003-04-22 08:12:33 +00002048\n\
Georg Brandld11ae5d2008-05-16 13:27:32 +00002049Returns the sum of an iterable of numbers (NOT strings) plus the value\n\
2050of parameter 'start' (which defaults to 0). When the iterable is\n\
Thomas Wouters89f507f2006-12-13 04:49:30 +00002051empty, returns start.");
Alex Martellia70b1912003-04-22 08:12:33 +00002052
2053
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002054static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002055builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002056{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002057 PyObject *inst;
2058 PyObject *cls;
2059 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002060
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002061 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
2062 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002063
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002064 retval = PyObject_IsInstance(inst, cls);
2065 if (retval < 0)
2066 return NULL;
2067 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002068}
2069
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002070PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002071"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002072\n\
2073Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002074With a type as second argument, return whether that is the object's type.\n\
2075The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002076isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002077
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002078
2079static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002080builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002081{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002082 PyObject *derived;
2083 PyObject *cls;
2084 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002085
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002086 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
2087 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002088
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002089 retval = PyObject_IsSubclass(derived, cls);
2090 if (retval < 0)
2091 return NULL;
2092 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002093}
2094
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002095PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002096"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002097\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002098Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2099When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2100is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002101
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002102
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002103typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002104 PyObject_HEAD
2105 Py_ssize_t tuplesize;
2106 PyObject *ittuple; /* tuple of iterators */
2107 PyObject *result;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002108} zipobject;
2109
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002110static PyObject *
2111zip_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
Barry Warsawbd599b52000-08-03 15:45:29 +00002112{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002113 zipobject *lz;
2114 Py_ssize_t i;
2115 PyObject *ittuple; /* tuple of iterators */
2116 PyObject *result;
2117 Py_ssize_t tuplesize = PySequence_Length(args);
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002118
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002119 if (type == &PyZip_Type && !_PyArg_NoKeywords("zip()", kwds))
2120 return NULL;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002121
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002122 /* args must be a tuple */
2123 assert(PyTuple_Check(args));
Barry Warsawbd599b52000-08-03 15:45:29 +00002124
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002125 /* obtain iterators */
2126 ittuple = PyTuple_New(tuplesize);
2127 if (ittuple == NULL)
2128 return NULL;
2129 for (i=0; i < tuplesize; ++i) {
2130 PyObject *item = PyTuple_GET_ITEM(args, i);
2131 PyObject *it = PyObject_GetIter(item);
2132 if (it == NULL) {
2133 if (PyErr_ExceptionMatches(PyExc_TypeError))
2134 PyErr_Format(PyExc_TypeError,
2135 "zip argument #%zd must support iteration",
2136 i+1);
2137 Py_DECREF(ittuple);
2138 return NULL;
2139 }
2140 PyTuple_SET_ITEM(ittuple, i, it);
2141 }
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002142
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002143 /* create a result holder */
2144 result = PyTuple_New(tuplesize);
2145 if (result == NULL) {
2146 Py_DECREF(ittuple);
2147 return NULL;
2148 }
2149 for (i=0 ; i < tuplesize ; i++) {
2150 Py_INCREF(Py_None);
2151 PyTuple_SET_ITEM(result, i, Py_None);
2152 }
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002153
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002154 /* create zipobject structure */
2155 lz = (zipobject *)type->tp_alloc(type, 0);
2156 if (lz == NULL) {
2157 Py_DECREF(ittuple);
2158 Py_DECREF(result);
2159 return NULL;
2160 }
2161 lz->ittuple = ittuple;
2162 lz->tuplesize = tuplesize;
2163 lz->result = result;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002164
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002165 return (PyObject *)lz;
Barry Warsawbd599b52000-08-03 15:45:29 +00002166}
2167
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002168static void
2169zip_dealloc(zipobject *lz)
2170{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002171 PyObject_GC_UnTrack(lz);
2172 Py_XDECREF(lz->ittuple);
2173 Py_XDECREF(lz->result);
2174 Py_TYPE(lz)->tp_free(lz);
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002175}
2176
2177static int
2178zip_traverse(zipobject *lz, visitproc visit, void *arg)
2179{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002180 Py_VISIT(lz->ittuple);
2181 Py_VISIT(lz->result);
2182 return 0;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002183}
2184
2185static PyObject *
2186zip_next(zipobject *lz)
2187{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002188 Py_ssize_t i;
2189 Py_ssize_t tuplesize = lz->tuplesize;
2190 PyObject *result = lz->result;
2191 PyObject *it;
2192 PyObject *item;
2193 PyObject *olditem;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002194
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002195 if (tuplesize == 0)
2196 return NULL;
2197 if (Py_REFCNT(result) == 1) {
2198 Py_INCREF(result);
2199 for (i=0 ; i < tuplesize ; i++) {
2200 it = PyTuple_GET_ITEM(lz->ittuple, i);
2201 item = (*Py_TYPE(it)->tp_iternext)(it);
2202 if (item == NULL) {
2203 Py_DECREF(result);
2204 return NULL;
2205 }
2206 olditem = PyTuple_GET_ITEM(result, i);
2207 PyTuple_SET_ITEM(result, i, item);
2208 Py_DECREF(olditem);
2209 }
2210 } else {
2211 result = PyTuple_New(tuplesize);
2212 if (result == NULL)
2213 return NULL;
2214 for (i=0 ; i < tuplesize ; i++) {
2215 it = PyTuple_GET_ITEM(lz->ittuple, i);
2216 item = (*Py_TYPE(it)->tp_iternext)(it);
2217 if (item == NULL) {
2218 Py_DECREF(result);
2219 return NULL;
2220 }
2221 PyTuple_SET_ITEM(result, i, item);
2222 }
2223 }
2224 return result;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002225}
Barry Warsawbd599b52000-08-03 15:45:29 +00002226
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002227PyDoc_STRVAR(zip_doc,
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002228"zip(iter1 [,iter2 [...]]) --> zip object\n\
Barry Warsawbd599b52000-08-03 15:45:29 +00002229\n\
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002230Return a zip object whose .__next__() method returns a tuple where\n\
2231the i-th element comes from the i-th iterable argument. The .__next__()\n\
2232method continues until the shortest iterable in the argument sequence\n\
Georg Brandlced51db2008-12-04 18:28:38 +00002233is exhausted and then it raises StopIteration.");
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002234
2235PyTypeObject PyZip_Type = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002236 PyVarObject_HEAD_INIT(&PyType_Type, 0)
2237 "zip", /* tp_name */
2238 sizeof(zipobject), /* tp_basicsize */
2239 0, /* tp_itemsize */
2240 /* methods */
2241 (destructor)zip_dealloc, /* tp_dealloc */
2242 0, /* tp_print */
2243 0, /* tp_getattr */
2244 0, /* tp_setattr */
2245 0, /* tp_reserved */
2246 0, /* tp_repr */
2247 0, /* tp_as_number */
2248 0, /* tp_as_sequence */
2249 0, /* tp_as_mapping */
2250 0, /* tp_hash */
2251 0, /* tp_call */
2252 0, /* tp_str */
2253 PyObject_GenericGetAttr, /* tp_getattro */
2254 0, /* tp_setattro */
2255 0, /* tp_as_buffer */
2256 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
2257 Py_TPFLAGS_BASETYPE, /* tp_flags */
2258 zip_doc, /* tp_doc */
2259 (traverseproc)zip_traverse, /* tp_traverse */
2260 0, /* tp_clear */
2261 0, /* tp_richcompare */
2262 0, /* tp_weaklistoffset */
2263 PyObject_SelfIter, /* tp_iter */
2264 (iternextfunc)zip_next, /* tp_iternext */
2265 0, /* tp_methods */
2266 0, /* tp_members */
2267 0, /* tp_getset */
2268 0, /* tp_base */
2269 0, /* tp_dict */
2270 0, /* tp_descr_get */
2271 0, /* tp_descr_set */
2272 0, /* tp_dictoffset */
2273 0, /* tp_init */
2274 PyType_GenericAlloc, /* tp_alloc */
2275 zip_new, /* tp_new */
2276 PyObject_GC_Del, /* tp_free */
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002277};
Barry Warsawbd599b52000-08-03 15:45:29 +00002278
2279
Guido van Rossum79f25d91997-04-29 20:08:16 +00002280static PyMethodDef builtin_methods[] = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002281 {"__build_class__", (PyCFunction)builtin___build_class__,
2282 METH_VARARGS | METH_KEYWORDS, build_class_doc},
2283 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
2284 {"abs", builtin_abs, METH_O, abs_doc},
2285 {"all", builtin_all, METH_O, all_doc},
2286 {"any", builtin_any, METH_O, any_doc},
2287 {"ascii", builtin_ascii, METH_O, ascii_doc},
2288 {"bin", builtin_bin, METH_O, bin_doc},
Antoine Pitroue71362d2010-11-27 22:00:11 +00002289 {"callable", builtin_callable, METH_O, callable_doc},
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002290 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2291 {"compile", (PyCFunction)builtin_compile, METH_VARARGS | METH_KEYWORDS, compile_doc},
2292 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2293 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2294 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2295 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2296 {"exec", builtin_exec, METH_VARARGS, exec_doc},
2297 {"format", builtin_format, METH_VARARGS, format_doc},
2298 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2299 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2300 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2301 {"hash", builtin_hash, METH_O, hash_doc},
2302 {"hex", builtin_hex, METH_O, hex_doc},
2303 {"id", builtin_id, METH_O, id_doc},
2304 {"input", builtin_input, METH_VARARGS, input_doc},
2305 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2306 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2307 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2308 {"len", builtin_len, METH_O, len_doc},
2309 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2310 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2311 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
2312 {"next", (PyCFunction)builtin_next, METH_VARARGS, next_doc},
2313 {"oct", builtin_oct, METH_O, oct_doc},
2314 {"ord", builtin_ord, METH_O, ord_doc},
2315 {"pow", builtin_pow, METH_VARARGS, pow_doc},
2316 {"print", (PyCFunction)builtin_print, METH_VARARGS | METH_KEYWORDS, print_doc},
2317 {"repr", builtin_repr, METH_O, repr_doc},
2318 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
2319 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
2320 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
2321 {"sum", builtin_sum, METH_VARARGS, sum_doc},
2322 {"vars", builtin_vars, METH_VARARGS, vars_doc},
2323 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002324};
2325
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002326PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002327"Built-in functions, exceptions, and other objects.\n\
2328\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002329Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002330
Martin v. Löwis1a214512008-06-11 05:26:20 +00002331static struct PyModuleDef builtinsmodule = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002332 PyModuleDef_HEAD_INIT,
2333 "builtins",
2334 builtin_doc,
2335 -1, /* multiple "initialization" just copies the module dict. */
2336 builtin_methods,
2337 NULL,
2338 NULL,
2339 NULL,
2340 NULL
Martin v. Löwis1a214512008-06-11 05:26:20 +00002341};
2342
2343
Guido van Rossum25ce5661997-08-02 03:10:38 +00002344PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002345_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002346{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002347 PyObject *mod, *dict, *debug;
2348 mod = PyModule_Create(&builtinsmodule);
2349 if (mod == NULL)
2350 return NULL;
2351 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002352
Tim Peters7571a0f2003-03-23 17:52:28 +00002353#ifdef Py_TRACE_REFS
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002354 /* "builtins" exposes a number of statically allocated objects
2355 * that, before this code was added in 2.3, never showed up in
2356 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2357 * result, programs leaking references to None and False (etc)
2358 * couldn't be diagnosed by examining sys.getobjects(0).
2359 */
Tim Peters7571a0f2003-03-23 17:52:28 +00002360#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2361#else
2362#define ADD_TO_ALL(OBJECT) (void)0
2363#endif
2364
Tim Peters4b7625e2001-09-13 21:37:17 +00002365#define SETBUILTIN(NAME, OBJECT) \
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002366 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2367 return NULL; \
2368 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002369
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002370 SETBUILTIN("None", Py_None);
2371 SETBUILTIN("Ellipsis", Py_Ellipsis);
2372 SETBUILTIN("NotImplemented", Py_NotImplemented);
2373 SETBUILTIN("False", Py_False);
2374 SETBUILTIN("True", Py_True);
2375 SETBUILTIN("bool", &PyBool_Type);
2376 SETBUILTIN("memoryview", &PyMemoryView_Type);
2377 SETBUILTIN("bytearray", &PyByteArray_Type);
2378 SETBUILTIN("bytes", &PyBytes_Type);
2379 SETBUILTIN("classmethod", &PyClassMethod_Type);
2380 SETBUILTIN("complex", &PyComplex_Type);
2381 SETBUILTIN("dict", &PyDict_Type);
2382 SETBUILTIN("enumerate", &PyEnum_Type);
2383 SETBUILTIN("filter", &PyFilter_Type);
2384 SETBUILTIN("float", &PyFloat_Type);
2385 SETBUILTIN("frozenset", &PyFrozenSet_Type);
2386 SETBUILTIN("property", &PyProperty_Type);
2387 SETBUILTIN("int", &PyLong_Type);
2388 SETBUILTIN("list", &PyList_Type);
2389 SETBUILTIN("map", &PyMap_Type);
2390 SETBUILTIN("object", &PyBaseObject_Type);
2391 SETBUILTIN("range", &PyRange_Type);
2392 SETBUILTIN("reversed", &PyReversed_Type);
2393 SETBUILTIN("set", &PySet_Type);
2394 SETBUILTIN("slice", &PySlice_Type);
2395 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2396 SETBUILTIN("str", &PyUnicode_Type);
2397 SETBUILTIN("super", &PySuper_Type);
2398 SETBUILTIN("tuple", &PyTuple_Type);
2399 SETBUILTIN("type", &PyType_Type);
2400 SETBUILTIN("zip", &PyZip_Type);
2401 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
2402 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2403 Py_XDECREF(debug);
2404 return NULL;
2405 }
2406 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002407
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002408 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002409#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002410#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002411}