Commit 09abd09ab85189b15c3296407a5a8a803e93ebd0 | zig

author	Andrew Kelley <andrew@ziglang.org> 2019-10-16 18:13:40-04:00
committer	Andrew Kelley <andrew@ziglang.org> 2019-10-16 18:13:40-04:00
log	09abd09ab85189b15c3296407a5a8a803e93ebd0
tree	57f6eecb5c6e5f9a8ca45ae5c69e2e9cabc6a6ac
parent	6a549a7f0cc337634c5dca6abf20eca53b572f21
signature	Commit is signed but in an unrecognized format.

1 files changed, 11 insertions(+), 3 deletions(-)

lib/std/fs/file.zig+11-3

 @@ -269,9 +269,17 @@ pub const File = struct {
     pub const UpdateTimesError = os.FutimensError || windows.SetFileTimeError;
-    /// `atime`: access timestamp in nanoseconds
+    /// The underlying file system may have a different granularity than nanoseconds,
-    /// `mtime`: last modification timestamp in nanoseconds
+    /// and therefore this function cannot guarantee any precision will be stored.
-    pub fn updateTimes(self: File, atime: i64, mtime: i64) UpdateTimesError!void {
+    /// Further, the maximum value is limited by the system ABI. When a value is provided
+    /// that exceeds this range, the value is clamped to the maximum.
+    pub fn updateTimes(
+        self: File,
+        /// access timestamp in nanoseconds
+        atime: i64,
+        /// last modification timestamp in nanoseconds
+        mtime: i64,
+    ) UpdateTimesError!void {
         if (windows.is_the_target) {
             const atime_ft = windows.nanoSecondsToFileTime(atime);
             const mtime_ft = windows.nanoSecondsToFileTime(mtime);