mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-02 08:02:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Fix docs for __import__ that say the default for 'level' is -1; it's actually

Browse source 
0.
This commit is contained in:
Brett Cannon 2009-03-15 02:18:41 +00:00
parent a113ac58be
commit 2b9fd47da7
1 changed files with 5 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

11
Doc/library/functions.rst
View file

@ -1207,9 +1207,8 @@ are always available. They are listed here in alphabetical order.
not use its *locals* argument at all, and uses its *globals* only to not use its *locals* argument at all, and uses its *globals* only to
determine the package context of the :keyword:`import` statement. determine the package context of the :keyword:`import` statement.
*level* specifies whether to use absolute or relative imports. The default *level* specifies whether to use absolute or relative imports. ``0`` (the
is ``-1`` which indicates both absolute and relative imports will be default) means only perform absolute imports. Positive values for
attempted. ``0`` means only perform absolute imports. Positive values for
*level* indicate the number of parent directories to search relative to the *level* indicate the number of parent directories to search relative to the
directory of the module calling :func:`__import__`. directory of the module calling :func:`__import__`.
@ -1221,11 +1220,11 @@ are always available. They are listed here in alphabetical order.
For example, the statement ``import spam`` results in bytecode resembling the For example, the statement ``import spam`` results in bytecode resembling the
following code:: following code::
spam = __import__('spam', globals(), locals(), [], -1) spam = __import__('spam', globals(), locals(), [], 0)
The statement ``import spam.ham`` results in this call:: The statement ``import spam.ham`` results in this call::
spam = __import__('spam.ham', globals(), locals(), [], -1) spam = __import__('spam.ham', globals(), locals(), [], 0)
Note how :func:`__import__` returns the toplevel module here because this is Note how :func:`__import__` returns the toplevel module here because this is
the object that is bound to a name by the :keyword:`import` statement. the object that is bound to a name by the :keyword:`import` statement.
@ -1233,7 +1232,7 @@ are always available. They are listed here in alphabetical order.
On the other hand, the statement ``from spam.ham import eggs, sausage as On the other hand, the statement ``from spam.ham import eggs, sausage as
saus`` results in :: saus`` results in ::
_temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], -1) _temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)
eggs = _temp.eggs eggs = _temp.eggs
saus = _temp.sausage saus = _temp.sausage