Packages  This Package  Prev  Next  Index

§2.10 Class FileOutputStream

public  class  java.io.FileOutputStream
    extends  java.io.OutputStream  (I-§2.15)
{
        // Constructors
    public FileOutputStream(File  file);	§2.10.1
    public FileOutputStream(FileDescriptor  fdObj);	§2.10.2
    public FileOutputStream(String  name);	§2.10.3

        // Methods
    public void close();	§2.10.4
    protected void finalize();	§2.10.5
    public final FileDescriptor getFD();	§2.10.6
    public void write(byte  b[]);	§2.10.7
    public void write(byte  b[], int  off, int  len);	§2.10.8
    public void write(int  b);	§2.10.9
}

A file output stream is an output stream for writing data to a File (I-§2.7) or to a FileDescriptor (I-§2.8).

FileOutputStream

public FileOutputStream(File  file)

throws IOException

Creates an file output stream to write to the specified File object

Parameters:: file -the file to be opened for writing
Throws: IOException (I-§2.29); If the file could not be opened for writing.
Throws: SecurityException (I-§1.43); If a security manager exists, its checkWrite method (I-§1.15.24) is called with the path name (I-§2.7.16) of the File argument to see if the application is allowed write access to the file. This may result in a security exception (I-§1.43).

FileOutputStream

public FileOutputStream(FileDescriptor  fdObj)

Creates an output file stream to write to the specified file descriptor

Parameters:: fdObj -the file descriptor to be opened for writing
Throws: SecurityException (I-§1.43); If a security manager exists, its checkWrite method (I-§1.15.23) is called with the file descriptor to see if the application is allowed to write to the specified file descriptor. This may result in a security exception (I-§1.43).

FileOutputStream

public FileOutputStream(String  name)

throws IOException

Creates an output file stream to write to the file with the specified name.

Parameters:: name -the system dependent file name
Throws: IOException (I-§2.29); If the file could not be opened for writing.
Throws: SecurityException (I-§1.43); If a security manager exists, its checkWrite method (I-§1.15.24) is called with the name argument to see if the application is allowed write access to the file. This may result in a security exception (I-§1.43).

close

public void close()

throws IOException

Closes this file output stream and releases any system resources associated with this stream.

Throws: IOException (I-§2.29); If an I/O error occurs.
Overrides:: close in class OutputStream (I-§2.15.2).

finalize

protected void finalize()

throws IOException

This finalize method ensures that the close method (I-§2.9.5) of this file output stream is called when there are no more references to this stream.

Throws: IOException (I-§2.29); If an I/O error occurs.
Overrides:: finalize in class Object (I-§1.12.4).

getFD

public final FileDescriptor getFD()

throws IOException

Returns:: the file descriptor object (I-§2.8) associated with this stream.
Throws: IOException (I-§2.29); If an I/O error occurs.

write

public void write(byte  b[])

throws IOException

Writes b.length bytes from the specified byte array to this file output stream.

Parameters:: b -the data
Throws: IOException (I-§2.29); If an I/O error occurs.
Overrides:: write in class OutputStream (I-§2.15.4).

write

public void write(byte  b[], int  off, int  len)

throws IOException

Writes len bytes from the specified byte array starting at offset off to this file output stream.

Parameters:: b -the data; off -the start offset in the data; len -the number of bytes to write
Throws: IOException (I-§2.29); If an I/O error occurs.
Overrides:: write in class OutputStream (I-§2.15.5).

write

public void write(int  b)

throws IOException

Writes the specified byte to this file output stream.

Parameters:: b -the byte to be written
Throws: IOException (I-§2.29); If an I/O error occurs.
Overrides:: write in class OutputStream (I-§2.15.6).

Packages  This Package  Prev  Next  Index