Add utility methods to write the contents of a file as one operation.

sdk/lib/io/file.dart

 // Copyright (c) 2012, 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.
 
 
 /**
  * FileMode describes the modes in which a file can be opened.
  */
 class FileMode {
   static const READ = const FileMode._internal(0);
@@ skipping 196 matching lines @@
    */
   Future<List<String>> readAsLines([Encoding encoding = Encoding.UTF_8]);
 
   /**
    * Synchronously read the entire file contents as lines of text
    * using the given [encoding].
    */
   List<String> readAsLinesSync([Encoding encoding = Encoding.UTF_8]);
 
   /**
+   * Write a list of bytes to a file.
+   *
+   * Opens the file, writes the list of bytes to it, and closes the file.
+   * Returns a [:Future<File>:] that completes with this [File] object once
+   * the entire operation has completed.
+   *
+   * By default [writeAsBytes] creates the file for writing and truncates the
+   * file if it already exists. In order to append the bytes to an existing
+   * file pass [:FileMode.APPEND:] as the optional mode parameter.
+   */
+  Future<File> writeAsBytes(List<int> bytes, [FileMode mode = FileMode.WRITE]);
+
+  /**
+   * Synchronously write a list of bytes to a file.
+   *
+   * Opens the file, writes the list of bytes to it and closses the file.
+   *
+   * By default [writeAsBytesSync] creates the file for writing and truncates
+   * the file if it already exists. In order to append the bytes to an existing
+   * file pass [:FileMode.APPEND:] as the optional mode parameter.
+   */
+  void writeAsBytesSync(List<int> bytes, [FileMode mode = FileMode.WRITE]);
+
+  /**
+   * Write a string to a file.
+   *
+   * Opens the file, writes the string in the given encoding, and closes the
+   * file. Returns a [:Future<File>:] that completes with this [File] object
+   * once the entire operation has completed.
+   *
+   * By default [writeAsString] creates the file for writing and truncates the
+   * file if it already exists. In order to append the bytes to an existing
+   * file pass [:FileMode.APPEND:] as the optional mode parameter.
+   */
+  Future<File> writeAsString(String contents,
+                             [Encoding encoding = Encoding.UTF_8,
+                              FileMode mode = FileMode.WRITE]);
+
+  /**
+   * Synchronously write a string to a file.
+   *
+   * Opens the file, writes the string in the given encoding, and closes the
+   * file.
+   *
+   * By default [writeAsStringSync] creates the file for writing and
+   * truncates the file if it already exists. In order to append the bytes
+   * to an existing file pass [:FileMode.APPEND:] as the optional mode
+   * parameter.
+   */
+  void writeAsStringSync(String contents,
+                         [Encoding encoding = Encoding.UTF_8,
+                          FileMode mode = FileMode.WRITE]);
+
+  /**
    * Get the name of the file.
    */
   String get name;
 }
 
 
 /**
  * [RandomAccessFile] provides random access to the data in a
  * file. [RandomAccessFile] objects are obtained by calling the
  * [:open:] method on a [File] object.
@@ skipping 153 matching lines @@
         sb.add(" ($osError)");
       }
     } else if (osError != null) {
       sb.add(": osError");
     }
     return sb.toString();
   }
   final String message;
   final OSError osError;
 }