Class Overview
Convenience class for writing character files. The constructors of this
class assume that the default character encoding and the default byte-buffer
size are acceptable. To specify these values yourself, construct an
OutputStreamWriter on a FileOutputStream.
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 FileWriter (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.
FileWriter
is meant for writing streams of characters.
For writing streams of raw bytes, consider using a
FileOutputStream
.
Summary
Public Constructors |
|
FileWriter(String fileName)
Constructs a FileWriter object given a file name.
|
|
FileWriter(String fileName, boolean append)
Constructs a FileWriter object given a file name with a boolean
indicating whether or not to append the data written.
|
|
FileWriter(File file)
Constructs a FileWriter object given a File object.
|
|
FileWriter(File file, boolean append)
Constructs a FileWriter object given a File object.
|
|
FileWriter(FileDescriptor fd)
Constructs a FileWriter object associated with a file descriptor.
|
[Expand]
Inherited Methods |
From class
java.io.OutputStreamWriter
void
|
close()
Closes the stream, flushing it first.
|
void
|
flush()
Flushes the stream.
|
String
|
getEncoding()
Returns the name of the character encoding being used by this stream.
|
void
|
write(char[] cbuf, int off, int len)
Writes a portion of an array of characters.
|
void
|
write(String str, int off, int len)
Writes a portion of a string.
|
void
|
write(int c)
Writes a single character.
|
|
From class
java.io.Writer
Writer
|
append(CharSequence csq)
Appends the specified character sequence to this writer.
|
Writer
|
append(CharSequence csq, int start, int end)
Appends a subsequence of the specified character sequence to this writer.
|
Writer
|
append(char c)
Appends the specified character to this writer.
|
abstract
void
|
close()
Closes the stream, flushing it first.
|
abstract
void
|
flush()
Flushes the stream.
|
void
|
write(char[] cbuf)
Writes an array of characters.
|
void
|
write(String str)
Writes a string.
|
abstract
void
|
write(char[] cbuf, int off, int len)
Writes a portion of an array of characters.
|
void
|
write(String str, int off, int len)
Writes a portion of a string.
|
void
|
write(int c)
Writes a single character.
|
|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
final
void
|
wait(long timeout, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long timeout)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
|
From interface
java.io.Closeable
abstract
void
|
close()
Closes this stream and releases any system resources associated
with it.
|
|
From interface
java.io.Flushable
abstract
void
|
flush()
Flushes this stream by writing any buffered output to the underlying
stream.
|
|
From interface
java.lang.Appendable
|
Public Constructors
public
FileWriter
(String fileName)
Constructs a FileWriter object given a file name.
Parameters
fileName
| String The system-dependent filename. |
Throws
IOException
| if the named 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
|
public
FileWriter
(String fileName, boolean append)
Constructs a FileWriter object given a file name with a boolean
indicating whether or not to append the data written.
Parameters
fileName
| String The system-dependent filename. |
append
| boolean if true , then data will be written
to the end of the file rather than the beginning. |
Throws
IOException
| if the named 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
|
public
FileWriter
(File file)
Constructs a FileWriter object given a File object.
Parameters
file
| a File object to write to. |
Throws
IOException
| 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
|
public
FileWriter
(File file, boolean append)
Constructs a FileWriter object given a File object. If the second
argument is true
, then bytes will be written to the end
of the file rather than the beginning.
Parameters
file
| a File object to write to |
append
| if true , then bytes will be written
to the end of the file rather than the beginning |
Throws
IOException
| 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 |
public
FileWriter
(FileDescriptor fd)
Constructs a FileWriter object associated with a file descriptor.
Parameters
fd
| FileDescriptor object to write to.
|