[dart:io] Adds functions to set file access and modification time

sdk/lib/io/file.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * The modes in which a File can be opened.
  */
 class FileMode {
@@ skipping 292 matching lines @@
   /**
    * Returns a [File] instance whose path is the absolute path to [this].
    *
    * The absolute path is computed by prefixing
    * a relative path with the current working directory, and returning
    * an absolute path unchanged.
    */
   File get absolute;
 
   /**
-   * Get the last-modified time of the file. Returns a
+   * Gets the last-accessed time of the file. Returns a
+   * [:Future<DateTime>:] that completes with a [DateTime] object for the
+   * access date.
+   */
+  Future<DateTime> lastAccessed();
+
+  /**
+   * Gets the last-accessed time of the file. Throws an exception
+   * if the file does not exist.
+   *
+   * Throws a [FileSystemException] if the operation fails.
+   */
+  DateTime lastAccessedSync();
+
+  /**
+   * Modifies the time the file was last accessed.
+   *
+   * Returns a [:Future<File>:] that completes with this
+   * [File] when the attributes have been set. If the access time
+   * cannot be set, the future completes with an exception.
+   */
+  Future<File> setLastAccessed(DateTime time);
+
+  /**
+   * Synchronously modifies the time the file was last accessed.
+   *
+   * If the attributes cannot be set, throws a [FileSystemException].
+   */
+  void setLastAccessedSync(DateTime time);
+
+  /**
+   * Gets the last-modified time of the file. Returns a
    * [:Future<DateTime>:] that completes with a [DateTime] object for the
    * modification date.
    */
   Future<DateTime> lastModified();
 
   /**
-   * Get the last-modified time of the file. Throws an exception
+   * Gets the last-modified time of the file. Throws an exception
    * if the file does not exist.
    *
    * Throws a [FileSystemException] if the operation fails.
    */
   DateTime lastModifiedSync();
 
   /**
+   * Modifies the time the file was last modified.
+   *
+   * Returns a [:Future<File>:] that completes with this
+   * [File] when the attributes have been set. If the modification
+   * time cannot be set, the future completes with an exception.
+   */
+  Future<File> setLastModified(DateTime time);
+
+  /**
+   * Synchronously modifies the time the file was last modified.
+   *
+   * If the attributes cannot be set, throws a [FileSystemException].
+   */
+  void setLastModifiedSync(DateTime time);
+
+  /**
    * Open the file for random access operations. Returns a
    * [:Future<RandomAccessFile>:] that completes with the opened
    * random access file. [RandomAccessFile]s must be closed using the
    * [RandomAccessFile.close] method.
    *
    * Files can be opened in three modes:
    *
    * [FileMode.READ]: open the file for reading.
    *
    * [FileMode.WRITE]: open the file for both reading and writing and
@@ skipping 552 matching lines @@
       sb.write(": $osError");
       if (path != null) {
         sb.write(", path = '$path'");
       }
     } else if (path != null) {
       sb.write(": $path");
     }
     return sb.toString();
   }
 }