RandomAccessFile class abstract
Random access to the data in a file.
RandomAccessFile
objects are obtained by calling the
open
method on a File object.
A RandomAccessFile
has both asynchronous and synchronous
methods. The asynchronous methods all return a Future
whereas the synchronous methods will return the result directly,
and block the current isolate until the result is ready.
At most one asynchronous method can be pending on a given RandomAccessFile
instance at the time. If another asynchronous method is called when one is
already in progress, a FileSystemException is thrown.
If an asynchronous method is pending, it is also not possible to call any synchronous methods. This will also throw a FileSystemException.
Constructors
Properties
Methods
-
close(
) → Future< void> - Closes the file.
-
flush(
) → Future< RandomAccessFile> - Flushes the contents of the file to disk.
-
length(
) → Future< int> - Gets the length of the file.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
position(
) → Future< int> - Gets the current byte position in the file.
-
read(
int count) → Future< Uint8List> -
Reads up to
count
bytes from a file. -
readByte(
) → Future< int> - Reads a byte from the file.
-
readInto(
List< int> buffer, [int start = 0, int? end]) → Future<int> -
Reads bytes into an existing
buffer
. -
setPosition(
int position) → Future< RandomAccessFile> - Sets the byte position in the file.
-
toString(
) → String -
A string representation of this object.
inherited
-
truncate(
int length) → Future< RandomAccessFile> -
Truncates (or extends) the file to
length
bytes. -
writeByte(
int value) → Future< RandomAccessFile> - Writes a single byte to the file.
-
writeFrom(
List< int> buffer, [int start = 0, int? end]) → Future<RandomAccessFile> -
Writes from a
buffer
to the file. -
writeString(
String string, {Encoding encoding = utf8}) → Future< RandomAccessFile> - Writes a string to the file using the given Encoding.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited