| Index: runtime/bin/file.dart
|
| diff --git a/runtime/bin/file.dart b/runtime/bin/file.dart
|
| index dee9462bee9cbb55dcae99331a15c63daebbfdf2..cfc5b77d3e67930d4cb9c518602d4e834d597d59 100644
|
| --- a/runtime/bin/file.dart
|
| +++ b/runtime/bin/file.dart
|
| @@ -96,19 +96,7 @@ interface File default _File {
|
| * can be performed. Opened RandomAccessFiles must be closed using
|
| * the [close] method.
|
| *
|
| - * Files can be opened in three modes:
|
| - *
|
| - * FileMode.READ: open the file for reading. If the file does not
|
| - * exist the [errorHandler] is called.
|
| - *
|
| - * FileMode.WRITE: open the file for both reading and writing and
|
| - * truncate the file to length zero. If the file does not exist the
|
| - * file is created.
|
| - *
|
| - * FileMode.APPEND: same as FileMode.WRITE except that the file is
|
| - * not truncated and the position is set to the end of the file.
|
| - *
|
| - * By default mode is FileMode.READ.
|
| + * See [open] for information on the [:mode:] argument.
|
| */
|
| RandomAccessFile openSync([FileMode mode]);
|
|
|
| @@ -126,12 +114,24 @@ interface File default _File {
|
|
|
| /**
|
| * Create a new independent input stream for the file. The file
|
| - * input stream must be closed when no longer used to free up
|
| - * system resources.
|
| + * input stream must be closed when no longer used to free up system
|
| + * resources. The [inputStreamHandler] is called with the result
|
| + * when the openInputStream operation completes.
|
| */
|
| InputStream openInputStream();
|
|
|
| /**
|
| + * Synchronously create a new independent input stream for the
|
| + * file. The file input stream must be closed when no longer used to
|
| + * free up system resources.
|
| + *
|
| + * Even though this call to open the input stream is synchronous the
|
| + * input stream itself is asynchronous as is the case for all input
|
| + * streams.
|
| + */
|
| + InputStream openInputStreamSync();
|
| +
|
| + /**
|
| * Creates a new independent output stream for the file. The file
|
| * output stream must be closed when no longer used to free up
|
| * system resources.
|
| @@ -149,6 +149,19 @@ interface File default _File {
|
| OutputStream openOutputStream([FileMode mode]);
|
|
|
| /**
|
| + * Synchronously creates a new independent output stream for the
|
| + * file. The file output stream must be closed when no longer used
|
| + * to free up system resources.
|
| + *
|
| + * 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]);
|
| +
|
| + /**
|
| * Get the name of the file.
|
| */
|
| String get name();
|
| @@ -178,6 +191,18 @@ interface File default _File {
|
| void set openHandler(void handler(RandomAccessFile openedFile));
|
|
|
| /**
|
| + * Sets the handler that gets called when an [openInputStream]
|
| + * operation completes.
|
| + */
|
| + 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));
|
| +
|
| + /**
|
| * Sets the handler that gets called when a [fullPath] operation
|
| * completes.
|
| */
|
|
|