FileOutputStream class

A file output stream is an output stream for writing data to a File or to a file descriptor.

FileOutputStream is meant for writing streams of raw bytes such as image data. For writing streams of characters, consider using FileWriter.

Example Usage

// Writing binary data
final output = FileOutputStream('output.bin');
try {
  final data = Uint8List.fromList([0x89, 0x50, 0x4E, 0x47]); // PNG header
  await output.writeBytes(data);
  await output.flush();
} finally {
  await output.close();
}

// Appending to existing file
final output = FileOutputStream('log.txt', append: true);
try {
  await output.writeString('New log entry\n');
  await output.flush();
} finally {
  await output.close();
}
Inheritance

Constructors

FileOutputStream(String name, {bool append = false})
Creates a file output stream to write to the file with the specified name.
FileOutputStream.fromFile(File file, {bool append = false})
Creates a file output stream to write to the specified File object.

Properties

file → File
Returns the File object associated with this stream.
no setter
hashCode → int
The hash code for this object.
no setterinherited
isAppendMode → bool
Returns whether this stream is in append mode.
no setter
isClosed → bool
Returns true if this stream has been closed.
no setterinherited
position → int
Returns the current position in the file.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

checkClosed() → void
Checks if the stream is closed and throws an exception if it is.
inherited
close() → Future<void>
Closes this output stream and releases any system resources associated with this stream.
override
flush() → Future<void>
Flushes this output stream and forces any buffered output bytes to be written out.
override
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited
write(List<int> b, [int offset = 0, int? length]) → Future<void>
Writes b.length bytes from the specified byte array to this output stream.
override
writeByte(int b) → Future<void>
Writes the specified byte to this output stream.
override
writeBytes(Uint8List data) → Future<void>
Writes all bytes from the specified Uint8List to this output stream.
inherited
writeObject(Object? obj) → Future<void>
Writes the given obj to the output stream.
override
writeString(String str, [Encoding? encoding]) → Future<void>
Writes a string to this output stream using UTF-8 encoding.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited