FileWriter JDK 1.6)

Description

public class FileWriter

Convenience class for writing character files.

See also: OutputStreamWriter FileOutputStream

Constructors

public FileWriter (File file) throws IOException

Constructs a FileWriter object given a File object.

public FileWriter (File file, boolean append) throws IOException

Constructs a FileWriter object given a File object.

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
Since: 1.4

public FileWriter (FileDescriptor fd)

Constructs a FileWriter object associated with a file descriptor.

public FileWriter (String fileName) throws IOException

Constructs a FileWriter object given a file name.

public FileWriter (String fileName, boolean append) throws IOException

Constructs a FileWriter object given a file name with a boolean indicating whether or not to append the data written.

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

Methods

Hide/Show inherited methods

public Writer append (char c) throws IOException [Inherited From Writer]

Appends the specified character to this writer.

An invocation of this method of the form out.append(c) behaves in exactly the same way as the invocation

     out.write(c)

Returns: This writer
Parameters:
- c - The 16-bit character to append
Throws:
- IOException - If an I/O error occurs
Since: 1.5

public Writer append (CharSequence csq) throws IOException [Inherited From Writer]

Appends the specified character sequence to this writer.

An invocation of this method of the form out.append(csq) behaves in exactly the same way as the invocation

     out.write(csq.toString())

Depending on the specification of toString for the character sequence csq, the entire sequence may not be appended. For instance, invoking the toString method of a character buffer will return a subsequence whose content depends upon the buffer's position and limit.
Returns: This writer
Parameters:
- csq - The character sequence to append. If csq is null, then the four characters "null" are appended to this writer.
Throws:
- IOException - If an I/O error occurs
Since: 1.5

public Writer append (CharSequence csq, int start, int end) throws IOException [Inherited From Writer]

Appends a subsequence of the specified character sequence to this writer.

Appends a subsequence of the specified character sequence to this writer. Appendable.

An invocation of this method of the form out.append(csq, start, end) when csq is not null behaves in exactly the same way as the invocation

     out.write(csq.subSequence(start, end).toString())

Returns: This writer
Parameters:
- csq - The character sequence from which a subsequence will be appended. If csq is null, then characters will be appended as if csq contained the four characters "null".
- start - The index of the first character in the subsequence
- end - The index of the character following the last character in the subsequence
Throws:
- IndexOutOfBoundsException - If start or end are negative, start is greater than end, or end is greater than csq.length()
- IOException - If an I/O error occurs
Since: 1.5

public void close () throws IOException [Inherited From OutputStreamWriter] [Specified in Writer]

public void flush () throws IOException [Inherited From OutputStreamWriter] [Specified in Writer]

Flushes the stream.

pack-private void flushBuffer () throws IOException [Inherited From OutputStreamWriter]

Flushes the output buffer to the underlying byte stream, without flushing the byte stream itself.

public String getEncoding () [Inherited From OutputStreamWriter]

Returns the name of the character encoding being used by this stream.

If the encoding has an historical name then that name is returned; otherwise the encoding's canonical name is returned.

If this instance was created with the OutputStreamWriter.OutputStreamWriter(OutputStream, String) constructor then the returned name, being unique for the encoding, may differ from the name passed to the constructor. This method may return null if the stream has been closed.

Returns: The historical name of this encoding, or possibly null if the stream has been closed
See Also: Charset,

public void write (char[] cbuf) throws IOException [Inherited From Writer]

Writes an array of characters.

public void write (char[] cbuf, int off, int len) throws IOException [Inherited From OutputStreamWriter] [Specified in Writer]

Writes a portion of an array of characters.

public void write (int c) throws IOException [Inherited From OutputStreamWriter]

Writes a single character.

public void write (String str) throws IOException [Inherited From Writer]

Writes a string.

public void write (String str, int off, int len) throws IOException [Inherited From OutputStreamWriter]

Writes a portion of a string.