java.lang.Object | ||
↳ | java.io.Writer | |
↳ | java.io.PipedWriter |
Places information on a communications pipe. When two threads want to pass data back and forth, one creates a piped writer and the other creates a piped reader.
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.io.Writer
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new unconnected
PipedWriter . | |||||||||||
Constructs a new
PipedWriter connected to destination . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Closes this writer.
| |||||||||||
Connects this
PipedWriter to a PipedReader . | |||||||||||
Notifies the readers of this
PipedReader that characters can be read. | |||||||||||
Writes
count characters from the character array buffer
starting at offset index to this writer. | |||||||||||
Writes a single character
c to this writer. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.io.Writer
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.io.Closeable
| |||||||||||
From interface
java.io.Flushable
| |||||||||||
From interface
java.lang.Appendable
| |||||||||||
From interface
java.lang.AutoCloseable
|
Constructs a new unconnected PipedWriter
. The resulting writer
must be connected to a PipedReader
before data may be written to
it.
Constructs a new PipedWriter
connected to destination
.
Any data written to this writer can be read from destination
.
destination | the PipedReader to connect to. |
---|
IOException | if destination is already connected.
|
---|
Closes this writer. If a PipedReader
is connected to this writer,
it is closed as well and the pipe is disconnected. Any data buffered in
the reader can still be read.
IOException | if an error occurs while closing this writer. |
---|
Connects this PipedWriter
to a PipedReader
. Any data
written to this writer becomes readable in the reader.
reader | the reader to connect to. |
---|
IOException | if this writer is closed or already connected, or if reader is already connected.
|
---|
Notifies the readers of this PipedReader
that characters can be read. This
method does nothing if this Writer is not connected.
IOException | if an I/O error occurs while flushing this writer. |
---|
Writes count
characters from the character array buffer
starting at offset index
to this writer. The written data can
then be read from the connected PipedReader
instance.
Separate threads should be used to write to a PipedWriter
and to
read from the connected PipedReader
. If the same thread is used,
a deadlock may occur.
buffer | the buffer to write. |
---|---|
offset | the index of the first character in buffer to write. |
count | the number of characters from buffer to write to this
writer. |
IndexOutOfBoundsException | if offset < 0 or count < 0 , or if offset + count is bigger than the length of buffer . |
---|---|
InterruptedIOException | if the pipe is full and the current thread is interrupted waiting for space to write data. This case is not currently handled correctly. |
IOException | if this writer is closed or not connected, if the target reader is closed or if the thread reading from the target reader is no longer alive. This case is currently not handled correctly. |
NullPointerException | if buffer is null .
|
Writes a single character c
to this writer. This character can
then be read from the connected PipedReader
instance.
Separate threads should be used to write to a PipedWriter
and to
read from the connected PipedReader
. If the same thread is used,
a deadlock may occur.
c | the character to write. |
---|
InterruptedIOException | if the pipe is full and the current thread is interrupted waiting for space to write data. This case is not currently handled correctly. |
---|---|
IOException | if this writer is closed or not connected, if the target reader is closed or if the thread reading from the target reader is no longer alive. This case is currently not handled correctly. |