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. |