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

#9921: clarify os.path.join joining algorithm

Browse source 
The new wording is based on the comments in the code, which
match the actual behavior.
This commit is contained in:
R David Murray 2011-06-23 21:19:25 -04:00
parent 1d3365106d
commit 17e2b40aae
1 changed files with 5 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/library/os.path.rst
View file

@ -196,10 +196,11 @@ write files see :func:`open`, and for accessing the filesystem see the
path, all previous components (on Windows, including the previous drive letter, path, all previous components (on Windows, including the previous drive letter,
if there was one) are thrown away, and joining continues. The return value is if there was one) are thrown away, and joining continues. The return value is
the concatenation of *path1*, and optionally *path2*, etc., with exactly one the concatenation of *path1*, and optionally *path2*, etc., with exactly one
directory separator (``os.sep``) inserted between components, unless *path2* is directory separator (``os.sep``) following each non-empty part except the last.
empty. Note that on Windows, since there is a current directory for each drive, (This means that an empty last part will result in a path that ends with a
``os.path.join("c:", "foo")`` represents a path relative to the current separator.) Note that on Windows, since there is a current directory for
directory on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\foo`. each drive, ``os.path.join("c:", "foo")`` represents a path relative to the
current directory on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\foo`.
.. function:: normcase(path) .. function:: normcase(path)