public class PipedWriter extends Writer
Constructor and Description |
---|
PipedWriter()
Creates a piped writer that is not yet connected to a
piped reader.
|
PipedWriter(PipedReader snk)
Creates a piped writer connected to the specified piped
reader.
|
Modifier and Type | Method and Description |
---|---|
void |
close()
Closes this piped output stream and releases any system resources
associated with this stream.
|
void |
connect(PipedReader snk)
Connects this piped writer to a receiver.
|
void |
flush()
Flushes this output stream and forces any buffered output characters
to be written out.
|
void |
write(char[] cbuf,
int off,
int len)
Writes
len characters from the specified character array
starting at offset off to this piped output stream. |
void |
write(int c)
Writes the specified
char to the piped output stream. |
public PipedWriter(PipedReader snk) throws IOException
snk
.snk
- The piped reader to connect to.IOException
- if an I/O error occurs.public PipedWriter()
public void connect(PipedReader snk) throws IOException
IOException
is thrown.
If snk
is an unconnected piped reader and
src
is an unconnected piped writer, they may
be connected by either the call:
or the call:src.connect(snk)
The two calls have the same effect.snk.connect(src)
snk
- the piped reader to connect to.IOException
- if an I/O error occurs.public void write(int c) throws IOException
char
to the piped output stream.
If a thread was reading data characters from the connected piped input
stream, but the thread is no longer alive, then an
IOException
is thrown.
Implements the write
method of Writer
.
write
in class Writer
c
- the char
to be written.IOException
- if the pipe is
broken
,
unconnected
, closed
or an I/O error occurs.public void write(char[] cbuf, int off, int len) throws IOException
len
characters from the specified character array
starting at offset off
to this piped output stream.
This method blocks until all the characters are written to the output
stream.
If a thread was reading data characters from the connected piped input
stream, but the thread is no longer alive, then an
IOException
is thrown.write
in class Writer
cbuf
- the data.off
- the start offset in the data.len
- the number of characters to write.IOException
- if the pipe is
broken
,
unconnected
, closed
or an I/O error occurs.public void flush() throws IOException
flush
in interface Flushable
flush
in class Writer
IOException
- if the pipe is closed, or an I/O error occurs.public void close() throws IOException
close
in interface Closeable
close
in interface AutoCloseable
close
in class Writer
IOException
- if an I/O error occurs. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138