diff options
author | Berker Peksag <berker.peksag@gmail.com> | 2016-08-13 02:37:49 (GMT) |
---|---|---|
committer | Berker Peksag <berker.peksag@gmail.com> | 2016-08-13 02:37:49 (GMT) |
commit | bd664357f12bb3b597607be96552c115cf8e9fc0 (patch) | |
tree | 9ad5d1ed34336da59b9502a17edfb10c88194932 /Doc/c-api/veryhigh.rst | |
parent | 6336fb27342e4f5ec76d73182d2c0af764a51777 (diff) | |
download | cpython-bd664357f12bb3b597607be96552c115cf8e9fc0.zip cpython-bd664357f12bb3b597607be96552c115cf8e9fc0.tar.gz cpython-bd664357f12bb3b597607be96552c115cf8e9fc0.tar.bz2 |
Issue #24637: Document that locals can be any mapping object
This behavior is already tested in test_general_eval in
Lib/test/test_builtin.py
Patch by Matthew Keeter.
Diffstat (limited to 'Doc/c-api/veryhigh.rst')
-rw-r--r-- | Doc/c-api/veryhigh.rst | 17 |
1 files changed, 9 insertions, 8 deletions
diff --git a/Doc/c-api/veryhigh.rst b/Doc/c-api/veryhigh.rst index 706efdf..e9c9377 100644 --- a/Doc/c-api/veryhigh.rst +++ b/Doc/c-api/veryhigh.rst @@ -219,9 +219,10 @@ the same library that the Python runtime is using. .. c:function:: PyObject* PyRun_StringFlags(const char *str, int start, PyObject *globals, PyObject *locals, PyCompilerFlags *flags) Execute Python source code from *str* in the context specified by the - dictionaries *globals* and *locals* with the compiler flags specified by - *flags*. The parameter *start* specifies the start token that should be used to - parse the source code. + objects *globals* and *locals* with the compiler flags specified by + *flags*. *globals* must be a dictionary; *locals* can be any object + that implements the mapping protocol. The parameter *start* specifies + the start token that should be used to parse the source code. Returns the result of executing the code as a Python object, or *NULL* if an exception was raised. @@ -295,16 +296,16 @@ the same library that the Python runtime is using. .. c:function:: PyObject* PyEval_EvalCode(PyObject *co, PyObject *globals, PyObject *locals) This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just - the code object, and the dictionaries of global and local variables. - The other arguments are set to *NULL*. + the code object, and global and local variables. The other arguments are + set to *NULL*. .. c:function:: PyObject* PyEval_EvalCodeEx(PyObject *co, PyObject *globals, PyObject *locals, PyObject **args, int argcount, PyObject **kws, int kwcount, PyObject **defs, int defcount, PyObject *closure) Evaluate a precompiled code object, given a particular environment for its - evaluation. This environment consists of dictionaries of global and local - variables, arrays of arguments, keywords and defaults, and a closure tuple of - cells. + evaluation. This environment consists of a dictionary of global variables, + a mapping object of local variables, arrays of arguments, keywords and + defaults, and a closure tuple of cells. .. c:type:: PyFrameObject |