java.io
Class Writer
java.lang.Object
|
+--java.io.Writer
public abstract class
Writerextends
Object This abstract class forms the base of the hierarchy of classes that
write output as a stream of chars. It provides a common set of methods
for writing chars to stream. Subclasses implement and/or extend these
methods to write chars in a particular manner or to a particular
destination such as a file on disk or network connection.
Authors:- Aaron M. Renn (arenn@urbanophile.com)
- Per Bothner <bothner@cygnus.com>
lock
protected Object lock
This is the object used to synchronize criticial code sections for
thread safety. Subclasses should use this field instead of using
synchronized methods or explicity synchronizations on this
Writer
protected Writer()
This is the default no-argument constructor for this class. This method
will set up the class to synchronize criticial sections on itself.
Writer
protected Writer(java.lang.Object lock)
This method initializes a Writer
that will synchronize
on the specified Object
.
Parameters:
close
public void close()
This method closes the stream. Any internal or native resources associated
with this stream are freed. Any subsequent attempt to access the stream
might throw an exception.
This method in this class does nothing.
Throws:
flush
public void flush()
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.
Throws:
write
public void write(char[] buf)
This method all the writes char from the passed array to the output stream.
This method is equivalent to write(buf, 0, buf.length)
which
is exactly how it is implemented in this class.
Parameters:
Throws:
write
public void write(char[] buf, int offset, int len)
This method writes
len
char from the specified array
buf
starting at index
offset
into the array.
Subclasses must provide an implementation of this abstract method.
Parameters:
Throws:
write
public void write(int b)
This method writes a single char to the output stream.
Parameters:
Throws:
write
public void write(java.lang.String str)
This method writes all the characters in a String
to the
output.
Parameters:
write
public void write(java.lang.String str, int offset, int len)
This method writes len
chars from the String
starting at position offset
.
Parameters:
Throws: