languages/dart-sdk
languages/dart-sdk
1
0
Fork 0
mirror of https://github.com/dart-lang/sdk synced 2024-10-14 17:59:39 +00:00
Code Issues Packages Projects Releases Wiki Activity

[io/doc] Document when read/readSync can return return less than requested bytes

Browse source 
Bug:https://github.com/dart-lang/sdk/issues/50034
Change-Id: Ib2f2b11bc3ae1fe241b71a43f2866233e066d8e2
CoreLibraryReviewExempt: Documentation-only change
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/328802
Reviewed-by: Alexander Aprelev <aam@google.com>
Commit-Queue: Brian Quinlan <bquinlan@google.com>
This commit is contained in:
Brian Quinlan 2023-09-29 21:21:38 +00:00 committed by Commit Queue
parent 850bfe016e
commit 3fae23ae69
1 changed files with 14 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
sdk/lib/io/file.dart
View file

@ -631,10 +631,24 @@ abstract interface class RandomAccessFile {
int readByteSync();
/// Reads up to [count] bytes from a file.
///
/// May return fewer than [count] bytes. This can happen, for example, when
/// reading past the end of a file or when reading from a pipe that does not
/// currently contain additional data.
///
/// An empty [Uint8List] will only be returned when reading past the end of
/// the file or when [count] is `0`.
Future<Uint8List> read(int count);
/// Synchronously reads up to [count] bytes from a file
///
/// May return fewer than [count] bytes. This can happen, for example, when
/// reading past the end of a file or when reading from a pipe that does not
/// currently contain additional data.
///
/// An empty [Uint8List] will only be returned when reading past the end of
/// the file or when [count] is `0`.
///
/// Throws a [FileSystemException] if the operation fails.
Uint8List readSync(int count);