diff options
author | Thomas Wouters <thomas@python.org> | 2000-08-17 22:55:00 (GMT) |
---|---|---|
committer | Thomas Wouters <thomas@python.org> | 2000-08-17 22:55:00 (GMT) |
commit | 5215225ea1e3200b572775639d567f5e3f489a15 (patch) | |
tree | 8202d4aebf513dc8c8a80adf018f13270386e658 /Doc/ref/ref6.tex | |
parent | 1d75a79c009e500923128716a02efbe86135e64e (diff) | |
download | cpython-5215225ea1e3200b572775639d567f5e3f489a15.zip cpython-5215225ea1e3200b572775639d567f5e3f489a15.tar.gz cpython-5215225ea1e3200b572775639d567f5e3f489a15.tar.bz2 |
Apply SF patch #101135, adding 'import module as m' and 'from module import
name as n'. By doing some twists and turns, "as" is not a reserved word.
There is a slight change in semantics for 'from module import name' (it will
now honour the 'global' keyword) but only in cases that are explicitly
undocumented.
Diffstat (limited to 'Doc/ref/ref6.tex')
-rw-r--r-- | Doc/ref/ref6.tex | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/Doc/ref/ref6.tex b/Doc/ref/ref6.tex index dc50c27..008cf1c 100644 --- a/Doc/ref/ref6.tex +++ b/Doc/ref/ref6.tex @@ -443,8 +443,9 @@ It continues with the next cycle of the nearest enclosing loop. \stindex{import} \begin{verbatim} -import_stmt: "import" module ("," module)* - | "from" module "import" identifier ("," identifier)* +import_stmt: "import" module ["as" name] ("," module ["as" name] )* + | "from" module "import" identifier ["as" name] + ("," identifier ["as" name] )* | "from" module "import" "*" module: (identifier ".")* identifier \end{verbatim} @@ -496,13 +497,16 @@ begin. The first form of \keyword{import} statement binds the module name in the local namespace to the module object, and then goes on to import the -next identifier, if any. The \keyword{from} form does not bind the -module name: it goes through the list of identifiers, looks each one -of them up in the module found in step (1), and binds the name in the -local namespace to the object thus found. If a name is not found, +next identifier, if any. If the module name is followed by \keyword{as}, +the name following \keyword{as} is used as the local name for the module. +The \keyword{from} form does not bind the module name: it goes through the +list of identifiers, looks each one of them up in the module found in step +(1), and binds the name in the local namespace to the object thus found. +Like with the first form of \keyword{import}, an alternate local name can be +supplied by specifying "\keyword{as} localname". If a name is not found, \exception{ImportError} is raised. If the list of identifiers is replaced -by a star (\samp{*}), all names defined in the module are bound, -except those beginning with an underscore (\character{_}). +by a star (\samp{*}), all names defined in the module are bound, except +those beginning with an underscore (\character{_}). \indexii{name}{binding} \exindex{ImportError} |