mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-11-26 19:34:19 +08:00
Code Issues Packages Projects Releases Wiki Activity

Document makedirs(), removedirs(), renames() -- ESR-inspired super-versions

Browse Source 
of mkdir(), rmdir() and rename() that make or remove intermediate
directories as well.
This commit is contained in:
Guido van Rossum 1998-07-24 20:48:20 +00:00
parent 4def7de7c6
commit 89a79d19b7
1 changed files with 30 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Doc/lib/libos.tex
View File

@ -68,7 +68,7 @@ or \code{None} if only one separator character exists. This is set to
\begin{datadesc}{pathsep}
The character conventionally used by the OS to separate search patch
components (as in \code{\$PATH}), e.g.\ \code{':'} for \POSIX{} or
components (as in \code{\$PATH}), e.g.\ \code{':'} for \POSIX{} or % $
\code{';'} for MS-DOS.
\end{datadesc}
@ -84,6 +84,35 @@ The default search path used by \code{exec*p*()} if the environment
doesn't have a \code{'PATH'} key.
\end{datadesc}
\begin{funcdesc}{makedirs}{path\optional{, mode}}
Recursive directory creation function. Like \function{mkdir()},
but makes all intermediate-level directories needed to contain the
leaf directory. Throws an \exception{os.error} exception if the leaf
directory already exists or cannot be created. The default \var{mode}
is \code{0777} (octal).
\end{funcdesc}
\begin{funcdesc}{removedirs}{path}
Recursive directory removal function. Works like
\function{rmdir()} except that, if the leaf directory is
successfully removed, directories corresponding to rightmost path
segments will be pruned way until either the whole path is consumed or
an error is raised (which is ignored, because it generally means that
a parent directory is not empty). Throws an \exception{os.error}
exception if the leaf directory could not be successfully removed.
\end{funcdesc}
\begin{funcdesc}{renames}{path}
Recursive directory or file renaming function.
Works like \function{rename()}, except creation of any intermediate
directories needed to make the new pathname good is attempted first.
After the rename, directories corresponding to rightmost path segments
of the old name will be pruned away using \function{removedirs()}.
Note: this function can fail with the new directory structure made if
you lack permissions needed to remove the leaf directory or file.
\end{funcdesc}
\begin{funcdesc}{execl}{path, arg0, arg1, ...}
This is equivalent to
\code{execv(\var{path}, (\var{arg0}, \var{arg1}, ...))}.