public class FileOutputStream extends OutputStream
File. Whether or not a file is available
or may be created depends upon the underlying platform. Some platforms, in particular, allow a file to be opened for
writing by only one FileOutputStream (or other file-writing object) at a time. In such situations the
constructors in this class will fail if the file involved is already open.
FileOutputStream is meant for writing streams of raw bytes such as image data. For writing streams of
characters, consider using FileWriter.
File,
FileInputStream| Constructor and Description |
|---|
FileOutputStream(File file)
Creates a file output stream to write to the file represented by the specified
File object. |
FileOutputStream(File file,
boolean append)
Creates a file output stream to write to the file represented by the specified
File object. |
FileOutputStream(String name)
Creates a file output stream to write to the file with the specified name.
|
FileOutputStream(String name,
boolean append)
Creates a file output stream to write to the file with the specified name.
|
| Modifier and Type | Method and Description |
|---|---|
void |
close()
Closes this file output stream and releases any system resources associated with this stream.
|
void |
write(byte[] b)
Writes
b.length bytes from the specified byte array to this file output stream. |
void |
write(byte[] b,
int off,
int len)
Writes
len bytes from the specified byte array starting at offset off to this file
output stream. |
void |
write(int b)
Writes the specified byte to this file output stream.
|
flushpublic FileOutputStream(File file) throws FileNotFoundException
File object.
First, if there is a security manager, its checkWrite method is called with the path represented by
the file argument as its argument.
If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot
be opened for any other reason then a FileNotFoundException is thrown.
file - the file to be opened for writing.FileNotFoundException - if the file exists but is a directory rather than a regular file, does not exist but cannot be
created, or cannot be opened for any other reasonSecurityException - if a security manager exists and its checkWrite method denies write access to the
file.File.getPath(),
SecurityExceptionpublic FileOutputStream(File file, boolean append) throws FileNotFoundException
File object. If the
second argument is true, then bytes will be written to the end of the file rather than the
beginning.
First, if there is a security manager, its checkWrite method is called with the path represented by
the file argument as its argument.
If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot
be opened for any other reason then a FileNotFoundException is thrown.
file - the file to be opened for writing.append - if true, then bytes will be written to the end of the file rather than the beginningFileNotFoundException - if the file exists but is a directory rather than a regular file, does not exist but cannot be
created, or cannot be opened for any other reasonSecurityException - if a security manager exists and its checkWrite method denies write access to the
file.File.getPath(),
SecurityExceptionpublic FileOutputStream(String name) throws FileNotFoundException
First, if there is a security manager, its checkWrite method is called with name as its
argument.
If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot
be opened for any other reason then a FileNotFoundException is thrown.
name - the system-dependent filenameFileNotFoundException - if the file exists but is a directory rather than a regular file, does not exist but cannot be
created, or cannot be opened for any other reasonSecurityException - if a security manager exists and its checkWrite method denies write access to the
file.public FileOutputStream(String name, boolean append) throws FileNotFoundException
true, then bytes will be written to the end of the file rather than the beginning.
First, if there is a security manager, its checkWrite method is called with name as its
argument.
If the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot
be opened for any other reason then a FileNotFoundException is thrown.
name - the system-dependent file nameappend - if true, then bytes will be written to the end of the file rather than the beginningFileNotFoundException - if the file exists but is a directory rather than a regular file, does not exist but cannot be
created, or cannot be opened for any other reason.SecurityException - if a security manager exists and its checkWrite method denies write access to the
file.public void close()
throws IOException
If this stream has an associated channel then the channel is closed as well.
close in interface Closeableclose in interface AutoCloseableclose in class OutputStreamIOException - if an I/O error occurs.public void write(byte[] b)
throws IOException
b.length bytes from the specified byte array to this file output stream.write in class OutputStreamb - the data.IOException - if an I/O error occurs.OutputStream.write(byte[], int, int)public void write(byte[] b,
int off,
int len)
throws IOException
len bytes from the specified byte array starting at offset off to this file
output stream.write in class OutputStreamb - the data.off - the start offset in the data.len - the number of bytes to write.IOException - if an I/O error occurs.public void write(int b)
throws IOException
write method of
OutputStream.write in class OutputStreamb - the byte to be written.IOException - if an I/O error occurs.