Closeable
, Flushable
, Appendable
, AutoCloseable
public class PipedWriter extends Writer
Constructor | 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 | 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.IndexOutOfBoundsException
- If off
is negative, or len
is negative,
or off + len
is negative or greater than the length
of the given arrayIOException
- 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 AutoCloseable
close
in interface Closeable
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, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps