All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.io.Writer 

java.lang.Object
   |
   +----java.io.Writer
public class Writer
extends Object
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.

See Also:
Writer, BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, FileWriter, PipedWriter, PrintWriter, StringWriter, Reader

Variable Index

o lock
The object used to synchronize operations on this stream.

Constructor Index

o Writer()
Create a new character-stream writer whose critical sections will synchronize on the writer itself.
o Writer(Object)
Create a new character-stream writer whose critical sections will synchronize on the given object.

Method Index

o close()
Close the stream, flushing it first.
o flush()
Flush the stream.
o write(char[])
Write an array of characters.
o write(char[], int, int)
Write a portion of an array of characters.
o write(int)
Write a single character.
o write(String)
Write a string.
o write(String, int, int)
Write a portion of a string.

Variables

o lock 
Properties Inheritable 
    lock=Object
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.

Constructors

o Writer 
    method Writer() Inheritable
Create a new character-stream writer whose critical sections will synchronize on the writer itself.

o Writer 
    method Writer(lock=Object) Inheritable
Create a new character-stream writer whose critical sections will synchronize on the given object.

Methods

o write 
    method write(c=int)  public     Signals IOException
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.

Throws: IOException
If an I/O error occurs
o write 
    method write(cbuf=char[])  public     Signals IOException
Write an array of characters.

Parameters:
cbuf - Array of characters to be written
Throws: IOException
If an I/O error occurs
o write 
    method write(cbuf=char[], -
                 off=int, -
                 len=int)  public abstract    Signals IOException
Write a portion of an array of characters.

Parameters:
cbuf - Array of characters
off - Offset from which to start writing characters
len - Number of characters to write
Throws: IOException
If an I/O error occurs
o write 
    method write(str=String)  public     Signals IOException
Write a string.

Parameters:
str - String to be written
Throws: IOException
If an I/O error occurs
o write 
    method write(str=String, -
                 off=int, -
                 len=int)  public     Signals IOException
Write a portion of a string.

Parameters:
str - A String
off - Offset from which to start writing characters
len - Number of characters to write
Throws: IOException
If an I/O error occurs
o flush 
    method flush()  public abstract    Signals IOException
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.

Throws: IOException
If an I/O error occurs
o close 
    method close()  public abstract    Signals IOException
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.

Throws: IOException
If an I/O error occurs 
All Packages  Class Hierarchy  This Package  Previous  Next  Index