Document general mappings for the locals argument for exec and execfile().

This commit is contained in:
Raymond Hettinger 2004-08-03 05:17:58 +00:00
parent a57ec93b93
commit 70fcdb8be0
2 changed files with 11 additions and 9 deletions

View file

@ -343,13 +343,14 @@ class C:
and does not create a new module.\footnote{It is used relatively
rarely so does not warrant being made into a statement.}
The arguments are a file name and two optional dictionaries. The
file is parsed and evaluated as a sequence of Python statements
(similarly to a module) using the \var{globals} and \var{locals}
dictionaries as global and local namespace. If the \var{locals}
dictionary is omitted it defaults to the \var{globals} dictionary.
If both dictionaries are omitted, the expression is executed in the
environment where \function{execfile()} is called. The return value is
The arguments are a file name and two optional dictionaries. The file is
parsed and evaluated as a sequence of Python statements (similarly to a
module) using the \var{globals} and \var{locals} dictionaries as global and
local namespace. If provided, \var{locals} can be any mapping object.
\versionchanged[formerly \var{locals} was required to be a dictionary]{2.4}
If the \var{locals} dictionary is omitted it defaults to the \var{globals}
dictionary. If both dictionaries are omitted, the expression is executed in
the environment where \function{execfile()} is called. The return value is
\code{None}.
\warning{The default \var{locals} act as described for function