Make IOSink implement StringSink

sdk/lib/io/file.dart

-// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// 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;
 
 /**
  * FileMode describes the modes in which a file can be opened.
  */
 class FileMode {
   static const READ = const FileMode._internal(0);
@@ skipping 155 matching lines @@
   /**
    * Creates a new independent [IOSink] for the file. The
    * [IOSink] must be closed when no longer used, to free
    * system resources.
    *
    * An [IOSink] for a file can be opened in two modes:
    *
    * * [FileMode.WRITE]: truncates the file to length zero.
    * * [FileMode.APPEND]: sets the initial write position to the end
    *   of the file.
+   *
+   *  When writing strings through the returned [IOSink] the encoding
+   *  specified using [encoding] will be used. The returned [IOSink]
+   *  has an [:encoding:] property which can be changed after the
+   *  [IOSink] has been created.
    */
-  IOSink<File> openWrite([FileMode mode = FileMode.WRITE]);
+  IOSink<File> openWrite({FileMode mode: FileMode.WRITE,
+                          Encoding encoding: Encoding.UTF_8});

[Anders Johnsen, 2013/03/07 16:53:49]

Thinking about this API change, I'm EXTREMELY excited about stuff like this.
This is a move in the right direction! :) Thanks Soeren!

[Søren Gjesse, 2013/03/08 09:47:46]

Thanks.

 
   /**
    * Read the entire file contents as a list of bytes. Returns a
    * [:Future<List<int>>:] that completes with the list of bytes that
    * is the contents of the file.
    */
   Future<List<int>> readAsBytes();
 
   /**
    * Synchronously read the entire file contents as a list of bytes.
@@ skipping 273 matching lines @@
         sb.write(" ($osError)");
       }
     } else if (osError != null) {
       sb.write(": osError");
     }
     return sb.toString();
   }
   final String message;
   final OSError osError;
 }