Implement File.{readAsBytes, readAsText, readAsLines}.

runtime/bin/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 final READ = const FileMode(0);
@@ skipping 158 matching lines @@
    *
    * See [openOutputStream] for information on the [:mode:] argument.
    *
    * Even though this call to open the output stream is synchronous
    * the output stream itself is asynchronous as is the case for all
    * output streams.
    */
   OutputStream openOutputStreamSync([FileMode mode]);
 
   /**
+   * Read the entire file contents as a list of bytes. When the
+   * operation completes the [readAsBytesHandler] is called.
+   * The [errorHandler] is called if the operation fails.
+   */
+  void readAsBytes();
+
+  /**
+   * Synchronously read the entire file contents as a list of bytes.
+   */
+  List<int> readAsBytesSync();
+
+  /**
+   * Read the entire file contents as text using the give [encoding]
+   * ('UTF-8', 'ISO-8859-1', 'ASCII'). By default the encoding is
+   * 'UTF-8'.
+   *
+   * When the operation completes the [readAsTextHandler] is called
+   * with the resulting string.  The [errorHandler] is called if the
+   * operation fails.
+   */
+  void readAsText([String encoding]);
+
+  /**
+   * Synchronously read the entire file contents as text using the
+   * give [encoding] ('UTF-8', 'ISO-8859-1', 'ASCII'). By default the
+   * encoding is 'UTF-8'.
+   */
+  String readAsTextSync([String encoding]);
+
+  /**
+   * Read the entire file contents as lines of text using the give
+   * [encoding] ('UTF-8', 'ISO-8859-1', 'ASCII'). By default the
+   * encoding is 'UTF-8'.
+   *
+   * When the operation completes the [readAsLinesHandler] is called
+   * with the resulting string.  The [errorHandler] is called if the
+   * operation fails.
+   */
+  void readAsLines();
+
+  /**
+   * Synchronously read the entire file contents as lines of text
+   * using the give [encoding] ('UTF-8', 'ISO-8859-1', 'ASCII'). By
+   * default the encoding is 'UTF-8'.
+   */
+  List<String> readAsLinesSync([String encoding]);
+
+  /**
    * Get the name of the file.
    */
   String get name();
 
   /**
    * Sets the handler that gets called when an [exists] operation
    * completes.
    */
   void set existsHandler(void handler(bool exists));
 
@@ skipping 27 matching lines @@
    */
   void set inputStreamHandler(void handler(InputStream stream));
 
   /**
    * Sets the handler that gets called when an [openOutputStream]
    * operation completes.
    */
   void set outputStreamHandler(void handler(OutputStream stream));
 
   /**
+   * Set the handler that gets called when a [readAsBytes] operation
+   * completes.
+   */
+  void set readAsBytesHandler(void handler(List<int> bytes));
+
+  /**
+   * Set the handler that gets called when a [readAsText] operation
+   * completes.
+   */
+  void set readAsTextHandler(void handler(String text));
+
+  /**
+   * Set the handler that gets called when a [readAsLines] operation
+   * completes.
+   */
+  void set readAsLinesHandler(void handler(List<String> lines));
+
+  /**
    * Sets the handler that gets called when a [fullPath] operation
    * completes.
    */
   void set fullPathHandler(void handler(String path));
 
   /**
    * Sets the handler that gets called when errors occur during
    * operations on this file.
    */
   void set errorHandler(void handler(String error));
@@ skipping 202 matching lines @@
    */
   void set errorHandler(void handler(String error));
 }
 
 
 class FileIOException implements Exception {
   const FileIOException([String this.message = ""]);
   String toString() => "FileIOException: $message";
   final String message;
 }