java.io

Class FileOutputStream

java.lang.Object

java.io.OutputStream

java.io.FileOutputStream

All Implemented Interfaces:

Closeable, Flushable

public class FileOutputStream
extends OutputStream

Writes a stream of bytes to a file.

Author:

Brian Bagnall

Constructor Summary

Constructors

Constructor and Description
FileOutputStream(File f) create a new OutputStream to write to this file, starting at the beginning of the file.
FileOutputStream(File f, boolean append) create a new OutputStream to write to this file
FileOutputStream(String name) This method initializes a FileInputStream to read from the specified named file.
FileOutputStream(String name, boolean append)

Method Summary

Modifier and Type	Method and Description
void	close() Write the buffer to flash memory and update the file parameters in flash.
void	flush() This method forces any data that may have been buffered to be written to the underlying output device.
void	write(int b) write 1 byte to the file; if necessary, file will be moved become the last file in memory

Methods inherited from class java.io.OutputStream

write, write

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileOutputStream

public FileOutputStream(File f)
                 throws FileNotFoundException,
                        IOException

create a new OutputStream to write to this file, starting at the beginning of the file.

Parameters:

f - the file this stream writes to

Throws:

FileNotFoundException

IOException

FileOutputStream

public FileOutputStream(File f,
                        boolean append)
                 throws IOException

create a new OutputStream to write to this file

Parameters:

f - the file this stream writes to

append - if true this stream will start writing at the end of the file, otherwise at the beginning

Throws:

IOException

FileOutputStream

public FileOutputStream(String name)
                 throws IOException

This method initializes a FileInputStream to read from the specified named file. A security check is first made to determine whether or not access to this file is allowed. This is done by calling the checkRead() method of the SecurityManager (if one exists) with the name of this file. An exception is thrown if reading is not allowed. If the file does not exist, an exception is also thrown.

Parameters:

name - The name of the file this stream should read from

Throws:

IOException

FileOutputStream

public FileOutputStream(String name,
                        boolean append)
                 throws IOException

Throws:

IOException

Method Detail

close

public void close()
           throws IOException

Write the buffer to flash memory and update the file parameters in flash. Resets pointers, so file can be written again from beginning with the same output stream.

Specified by:

close in interface Closeable

Overrides:

close in class OutputStream

Throws:

IOException - If an error occurs

flush

public void flush()
           throws IOException

Description copied from class: OutputStream

This method forces any data that may have been buffered to be written to the underlying output device. Please note that the host environment might perform its own buffering unbeknowst to Java. In that case, a write made (for example, to a disk drive) might be cached in OS buffers instead of actually being written to disk.

This method in this class does nothing.

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException - If an error occurs

write

public void write(int b)
           throws IOException

write 1 byte to the file; if necessary, file will be moved become the last file in memory

Specified by:

write in class OutputStream

Parameters:

b - The byte to be written to the output stream, passed as the low eight bits of an int

Throws:

IOException - If an error occurs