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

Document that writeAsBytes truncates values beyond 0..255

Browse source 
Closes https://github.com/dart-lang/sdk/pull/53782

GitOrigin-RevId: 5453268e4ebad23c4085efbab78b53cec551930d
Change-Id: I7804cbe65c93bc34f56db6da7bc68aa1ef4e9303
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/330944
Commit-Queue: Brian Quinlan <bquinlan@google.com>
Reviewed-by: Lasse Nielsen <lrn@google.com>
This commit is contained in:
Brian Quinlan 2023-11-10 23:54:40 +00:00 committed by Commit Queue
parent 5c9186fc1c
commit a826354365
1 changed files with 10 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -520,6 +520,11 @@ abstract interface class File implements FileSystemEntity {
/// file if it already exists. In order to append the bytes to an existing
/// file, pass [FileMode.append] as the optional mode parameter.
///
/// The elements of [bytes] should be integers in the range 0 to 255.
/// Any integer, which is not in that range, is converted to a byte before
/// being written. The conversion is equivalent to doing
/// `value.toUnsigned(8)`.
///
/// If the argument [flush] is set to `true`, the data written will be
/// flushed to the file system before the returned future completes.
Future<File> writeAsBytes(List<int> bytes,
@ -533,6 +538,11 @@ abstract interface class File implements FileSystemEntity {
/// the file if it already exists. In order to append the bytes to an existing
/// file, pass [FileMode.append] as the optional mode parameter.
///
/// The elements of [bytes] should be integers in the range 0 to 255.
/// Any integer, which is not in that range, is converted to a byte before
/// being written. The conversion is equivalent to doing
/// `value.toUnsigned(8)`.
///
/// If the [flush] argument is set to `true` data written will be
/// flushed to the file system before returning.
///