mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

note how os.utime should be used for emulating touch

Browse source
This commit is contained in:
Benjamin Peterson 2008-08-16 03:13:07 +00:00
parent 4eb993939d
commit 5b02ef3e1b
1 changed files with 10 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

19
Doc/library/os.rst
View file

@ -1303,15 +1303,16 @@ Files and Directories
.. function:: utime(path, times)
Set the access and modified times of the file specified by *path*. If *times* is
``None``, then the file's access and modified times are set to the current time.
Otherwise, *times* must be a 2-tuple of numbers, of the form ``(atime, mtime)``
which is used to set the access and modified times, respectively. Whether a
directory can be given for *path* depends on whether the operating system
implements directories as files (for example, Windows does not). Note that the
exact times you set here may not be returned by a subsequent :func:`stat` call,
depending on the resolution with which your operating system records access and
modification times; see :func:`stat`.
Set the access and modified times of the file specified by *path*. If *times*
is ``None``, then the file's access and modified times are set to the current
time. (The effect is similar to running the Unix program :program:`touch` on
the path.) Otherwise, *times* must be a 2-tuple of numbers, of the form
``(atime, mtime)`` which is used to set the access and modified times,
respectively. Whether a directory can be given for *path* depends on whether
the operating system implements directories as files (for example, Windows
does not). Note that the exact times you set here may not be returned by a
subsequent :func:`stat` call, depending on the resolution with which your
operating system records access and modification times; see :func:`stat`.
.. versionchanged:: 2.0
Added support for ``None`` for *times*.