java.io

クラス PipedWriter

java.lang.Object

java.io.Writer

java.io.PipedWriter

すべての実装されたインタフェース:

Closeable、Flushable、Appendable、AutoCloseable

public class PipedWriter
extends Writer

パイプによる文字出力ストリームです。

導入されたバージョン:

JDK1.1

フィールドのサマリー

クラス java.io.Writer から継承されたフィールド

lock

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
PipedWriter() パイプで連結されたリーダーにまだ接続されていない状態で、パイプで連結されたライターを作成します。
PipedWriter(PipedReader snk) パイプで連結されたライターを作成し、指定されたパイプで連結されたリーダーに接続します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	close() パイプで連結された出力ストリームを閉じ、このストリームに関連するすべてのシステムリソースを解放します。
void	connect(PipedReader snk) パイプで連結されたライターを受信側に接続します。
void	flush() 出力ストリームをフラッシュして、バッファリングされていたすべての出力文字を強制的に書き込みます。
void	write(char[] cbuf, int off, int len) 指定された文字配列の、オフセット位置 off から始まる len 文字を、このパイプで連結された出力ストリームに書き込みます。
void	write(int c) 指定された char を、パイプで連結された出力ストリームに書き込みます。

クラス java.io.Writer から継承されたメソッド

append, append, append, write, write, write

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

PipedWriter

public PipedWriter(PipedReader snk)
            throws IOException

パイプで連結されたライターを作成し、指定されたパイプで連結されたリーダーに接続します。このストリームに書き込まれたデータ文字は、snk からの入力として使えるようになります。

パラメータ:

snk - パイプによる接続先のリーダー。

例外:

IOException - 入出力エラーが発生した場合。

PipedWriter

public PipedWriter()

パイプで連結されたリーダーにまだ接続されていない状態で、パイプで連結されたライターを作成します。使用前に、受信側と送信側のいずれかで、パイプで連結されたリーダーに接続する必要があります。

関連項目:

PipedReader.connect(java.io.PipedWriter), connect(java.io.PipedReader)

メソッドの詳細

connect

public void connect(PipedReader snk)
             throws IOException

パイプで連結されたライターを受信側に接続します。このオブジェクトが別のパイプで連結されたリーダーにすでに接続されている場合は、IOException がスローされます。

snk がパイプによる未接続のリーダーで、src がパイプによる未接続のライターである場合、それらは以下の呼び出しのどちらかによって接続されます。

 src.connect(snk)

または

 snk.connect(src)

2 つの呼び出しは同じ効果を持ちます。

パラメータ:

snk - パイプによる接続先のリーダー。

例外:

IOException - 入出力エラーが発生した場合。

write

public void write(int c)
           throws IOException

指定された char を、パイプで連結された出力ストリームに書き込みます。接続されているパイプで連結された入力ストリームからスレッドがデータ文字を読み込んでいたときに、スレッドが無効になった場合、IOException がスローされます。

Writer の write メソッドを実装します。

オーバーライド:

write、クラス: Writer

パラメータ:

c - 書き込まれる char。

例外:

IOException - パイプが broken の状態である場合、unconnected の状態である場合、閉じられている場合、または入出力エラーが発生した場合。

write

public void write(char[] cbuf,
         int off,
         int len)
           throws IOException

指定された文字配列の、オフセット位置 off から始まる len 文字を、このパイプで連結された出力ストリームに書き込みます。このメソッドは、出力ストリームにすべての文字が書き込まれるまでブロックします。接続されているパイプで連結された入力ストリームからスレッドがデータ文字を読み込んでいたときに、スレッドが無効になった場合、IOException がスローされます。

定義:

write、クラス: Writer

パラメータ:

cbuf - データ。

off - データの開始オフセット。

len - 書き込む文字数。

例外:

IOException - パイプが broken の状態である場合、unconnected の状態である場合、閉じられている場合、または入出力エラーが発生した場合。

flush

public void flush()
           throws IOException

出力ストリームをフラッシュして、バッファリングされていたすべての出力文字を強制的に書き込みます。文字がパイプ内で待機中であることをリーダーに通知します。

定義:

flush、インタフェース: Flushable

定義:

flush、クラス: Writer

例外:

IOException - パイプが閉じられた場合、または入出力エラーが発生した場合。

close

public void close()
           throws IOException

パイプで連結された出力ストリームを閉じ、このストリームに関連するすべてのシステムリソースを解放します。以降、このストリームを文字の書き込みに使用することはできません。

定義:

close、インタフェース: Closeable

定義:

close、インタフェース: AutoCloseable

定義:

close、クラス: Writer

例外:

IOException - 入出力エラーが発生した場合。