| % File src/library/base/man/Sys.setFileTime.Rd |
| % Part of the R package, https://www.R-project.org |
| % Copyright 2011-2018 R Core Team |
| % Distributed under GPL 2 or later |
| |
| \name{Sys.setFileTime} |
| \alias{Sys.setFileTime} |
| \title{ |
| Set File Time |
| } |
| \description{ |
| Uses system calls to set the times on a file or directory. |
| } |
| \usage{ |
| Sys.setFileTime(path, time) |
| } |
| |
| \arguments{ |
| \item{path}{ |
| A character vector containing file or directory paths. |
| } |
| \item{time}{ |
| A date-time of class \code{"\link{POSIXct}"} or an object which can be |
| coerced to one. Fractions of a second may be ignored. Recycled along |
| \code{paths}. |
| } |
| } |
| \details{ |
| This attempts sets the file time to the value specified. |
| |
| On a Unix-alike it uses the system call \code{utimensat} if that is |
| available, otherwise \code{utimes} or \code{utime}. On a POSIX file |
| system it sets both the last-access and modification times. |
| Fractional seconds will set as from \R 3.4.0 on OSes with the |
| requisite system calls and suitable filesystems. |
| |
| On Windows it uses the system call \code{SetFileTime} to set the |
| \sQuote{last write time}. Some Windows file systems only record the |
| time at a resolution of two seconds. |
| |
| \code{Sys.setFileTime} has been vectorized in \R 3.6.0. Earlier versions |
| of \R required \code{path} and \code{time} to be vectors of length one. |
| } |
| \value{ |
| A logical vector indicating if the operation succeeded for each of the |
| files and directories attempted, returned invisibly. |
| } |
| \keyword{file} |
| |