| OLD | NEW |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 part of dart.io; | 5 part of dart.io; |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * The modes in which a File can be opened. | 8 * The modes in which a File can be opened. |
| 9 */ | 9 */ |
| 10 class FileMode { | 10 class FileMode { |
| (...skipping 555 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 566 | 566 |
| 567 /** | 567 /** |
| 568 * Reads into an existing List<int> from the file. If [start] is present, the | 568 * Reads into an existing List<int> from the file. If [start] is present, the |
| 569 * bytes will be filled into [buffer] from at index [start], otherwise index | 569 * bytes will be filled into [buffer] from at index [start], otherwise index |
| 570 * 0. If [end] is present, the [end] - [start] bytes will be read into | 570 * 0. If [end] is present, the [end] - [start] bytes will be read into |
| 571 * [buffer], otherwise up to [buffer.length]. If [end] == [start] nothing | 571 * [buffer], otherwise up to [buffer.length]. If [end] == [start] nothing |
| 572 * happends. | 572 * happends. |
| 573 * | 573 * |
| 574 * Returns a [:Future<int>:] that completes with the number of bytes read. | 574 * Returns a [:Future<int>:] that completes with the number of bytes read. |
| 575 */ | 575 */ |
| 576 Future<int> readInto(List<int> buffer, [int start, int end]); | 576 Future<int> readInto(List<int> buffer, [int start = 0, int end]); |
| 577 | 577 |
| 578 /** | 578 /** |
| 579 * Synchronously reads into an existing List<int> from the file. If [start] is | 579 * Synchronously reads into an existing List<int> from the file. If [start] is |
| 580 * present, the bytes will be filled into [buffer] from at index [start], | 580 * present, the bytes will be filled into [buffer] from at index [start], |
| 581 * otherwise index 0. If [end] is present, the [end] - [start] bytes will be | 581 * otherwise index 0. If [end] is present, the [end] - [start] bytes will be |
| 582 * read into [buffer], otherwise up to [buffer.length]. If [end] == [start] | 582 * read into [buffer], otherwise up to [buffer.length]. If [end] == [start] |
| 583 * nothing happends. | 583 * nothing happends. |
| 584 * | 584 * |
| 585 * Throws a [FileSystemException] if the operation fails. | 585 * Throws a [FileSystemException] if the operation fails. |
| 586 */ | 586 */ |
| 587 int readIntoSync(List<int> buffer, [int start, int end]); | 587 int readIntoSync(List<int> buffer, [int start = 0, int end]); |
| 588 | 588 |
| 589 /** | 589 /** |
| 590 * Writes a single byte to the file. Returns a | 590 * Writes a single byte to the file. Returns a |
| 591 * [:Future<RandomAccessFile>:] that completes with this | 591 * [:Future<RandomAccessFile>:] that completes with this |
| 592 * RandomAccessFile when the write completes. | 592 * RandomAccessFile when the write completes. |
| 593 */ | 593 */ |
| 594 Future<RandomAccessFile> writeByte(int value); | 594 Future<RandomAccessFile> writeByte(int value); |
| 595 | 595 |
| 596 /** | 596 /** |
| 597 * Synchronously writes a single byte to the file. Returns the | 597 * Synchronously writes a single byte to the file. Returns the |
| 598 * number of bytes successfully written. | 598 * number of bytes successfully written. |
| 599 * | 599 * |
| 600 * Throws a [FileSystemException] if the operation fails. | 600 * Throws a [FileSystemException] if the operation fails. |
| 601 */ | 601 */ |
| 602 int writeByteSync(int value); | 602 int writeByteSync(int value); |
| 603 | 603 |
| 604 /** | 604 /** |
| 605 * Writes from a [List<int>] to the file. It will read the buffer from index | 605 * Writes from a [List<int>] to the file. It will read the buffer from index |
| 606 * [start] to index [end]. If [start] is omitted, it'll start from index 0. | 606 * [start] to index [end]. If [start] is omitted, it'll start from index 0. |
| 607 * If [end] is omitted, it will write to end of [buffer]. | 607 * If [end] is omitted, it will write to end of [buffer]. |
| 608 * | 608 * |
| 609 * Returns a [:Future<RandomAccessFile>:] that completes with this | 609 * Returns a [:Future<RandomAccessFile>:] that completes with this |
| 610 * [RandomAccessFile] when the write completes. | 610 * [RandomAccessFile] when the write completes. |
| 611 */ | 611 */ |
| 612 Future<RandomAccessFile> writeFrom(List<int> buffer, [int start, int end]); | 612 Future<RandomAccessFile> writeFrom( |
| 613 List<int> buffer, [int start = 0, int end]); |
| 613 | 614 |
| 614 /** | 615 /** |
| 615 * Synchronously writes from a [List<int>] to the file. It will read the | 616 * Synchronously writes from a [List<int>] to the file. It will read the |
| 616 * buffer from index [start] to index [end]. If [start] is omitted, it'll | 617 * buffer from index [start] to index [end]. If [start] is omitted, it'll |
| 617 * start from index 0. If [end] is omitted, it will write to the end of | 618 * start from index 0. If [end] is omitted, it will write to the end of |
| 618 * [buffer]. | 619 * [buffer]. |
| 619 * | 620 * |
| 620 * Throws a [FileSystemException] if the operation fails. | 621 * Throws a [FileSystemException] if the operation fails. |
| 621 */ | 622 */ |
| 622 void writeFromSync(List<int> buffer, [int start, int end]); | 623 void writeFromSync(List<int> buffer, [int start = 0, int end]); |
| 623 | 624 |
| 624 /** | 625 /** |
| 625 * Writes a string to the file using the given [Encoding]. Returns a | 626 * Writes a string to the file using the given [Encoding]. Returns a |
| 626 * [:Future<RandomAccessFile>:] that completes with this | 627 * [:Future<RandomAccessFile>:] that completes with this |
| 627 * RandomAccessFile when the write completes. | 628 * RandomAccessFile when the write completes. |
| 628 */ | 629 */ |
| 629 Future<RandomAccessFile> writeString(String string, | 630 Future<RandomAccessFile> writeString(String string, |
| 630 {Encoding encoding: UTF8}); | 631 {Encoding encoding: UTF8}); |
| 631 | 632 |
| 632 /** | 633 /** |
| (...skipping 228 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 861 sb.write(": $osError"); | 862 sb.write(": $osError"); |
| 862 if (path != null) { | 863 if (path != null) { |
| 863 sb.write(", path = '$path'"); | 864 sb.write(", path = '$path'"); |
| 864 } | 865 } |
| 865 } else if (path != null) { | 866 } else if (path != null) { |
| 866 sb.write(": $path"); | 867 sb.write(": $path"); |
| 867 } | 868 } |
| 868 return sb.toString(); | 869 return sb.toString(); |
| 869 } | 870 } |
| 870 } | 871 } |
| OLD | NEW |