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

View file

@ -873,8 +873,9 @@ In all cases, if the optional parts are omitted, the code is executed
in the current scope. If only the first expression after \keyword{in}
is specified, it should be a dictionary, which will be used for both
the global and the local variables. If two expressions are given,
both must be dictionaries and they are used for the global and local
variables, respectively.
they are used for the global and local variables, respectively.
If provided, \var{locals} can be any mapping object.
\versionchanged[formerly \var{locals} was required to be a dictionary]{2.4}
As a side effect, an implementation may insert additional keys into
the dictionaries given besides those corresponding to variable names