| java.lang.Object
 java.io.Writer
| Writer | | abstract public class Writer (Code) | | Abstract class for writing to character streams. The only methods that a
subclass must implement are write(char[], int, int), flush(), and close().
Most subclasses, however, will override some of the methods defined here in
order to provide higher efficiency, additional functionality, or both.
version:
12/17/01 (CLDC 1.1)
since:
JDK1.1, CLDC 1.0
See Also: java.io.OutputStreamWriter
See Also: java.io.Reader |
| Field Summary | |
| protected Object | lock
The object used to synchronize operations on this stream. |
| Constructor Summary | |
| protected | Writer()
Create a new character-stream writer whose critical sections will
synchronize on the writer itself. | | protected | Writer(Object lock)
Create a new character-stream writer whose critical sections will
synchronize on the given object. |
| Method Summary | |
| abstract public void | close()
Close the stream, flushing it first. | | abstract public void | flush()
Flush the stream. | | public void | write(int c)
Write a single character. | | public void | write(char cbuf)
Write an array of characters. | | abstract public void | write(char cbuf, int off, int len)
Write a portion of an array of characters. | | public void | write(String str)
Write a string. | | public void | write(String str, int off, int len)
Write a portion of a string. |
| lock | | protected Object lock(Code) | | The object used to synchronize operations on this stream. For
efficiency, a character-stream object may use an object other than
itself to protect critical sections. A subclass should therefore use
the object in this field rather than this or a synchronized
method.
|
| Writer | | protected Writer()(Code) | | Create a new character-stream writer whose critical sections will
synchronize on the writer itself.
|
| Writer | | protected Writer(Object lock)(Code) | | Create a new character-stream writer whose critical sections will
synchronize on the given object.
Parameters:
lock - Object to synchronize on. |
| close | | abstract public void close() throws IOException(Code) | | Close the stream, flushing it first. Once a stream has been closed,
further write() or flush() invocations will cause an IOException to be
thrown. Closing a previously-closed stream, however, has no effect.
exception:
IOException - If an I/O error occurs |
| flush | | abstract public void flush() throws IOException(Code) | | Flush the stream. If the stream has saved any characters from the
various write() methods in a buffer, write them immediately to their
intended destination. Then, if that destination is another character or
byte stream, flush it. Thus one flush() invocation will flush all the
buffers in a chain of Writers and OutputStreams.
exception:
IOException - If an I/O error occurs |
| write | | public void write(int c) throws IOException(Code) | | Write a single character. The character to be written is contained in
the 16 low-order bits of the given integer value; the 16 high-order bits
are ignored.
Subclasses that intend to support efficient single-character output
should override this method.
Parameters:
c - int specifying a character to be written.
exception:
IOException - If an I/O error occurs |
| write | | public void write(char cbuf) throws IOException(Code) | | Write an array of characters.
Parameters:
cbuf - Array of characters to be written
exception:
IOException - If an I/O error occurs |
| write | | abstract public void write(char cbuf, int off, int len) throws IOException(Code) | | Write a portion of an array of characters.
Parameters:
cbuf - Array of characters
Parameters:
off - Offset from which to start writing characters
Parameters:
len - Number of characters to write
exception:
IOException - If an I/O error occurs |
| write | | public void write(String str, int off, int len) throws IOException(Code) | | Write a portion of a string.
Parameters:
str - A String
Parameters:
off - Offset from which to start writing characters
Parameters:
len - Number of characters to write
exception:
IOException - If an I/O error occurs |
|
|