java.io
クラス PipedWriter

java.lang.Object
  java.io.Writer
      java.io.PipedWriter

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

Closeable, Flushable, Appendable

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 メソッドを実装します。

オーバーライド:

クラス Writer 内の write

パラメータ:

c - 書き込まれる char

例外:

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

write

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

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

定義:

クラス Writer 内の write

パラメータ:

cbuf - データ

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

len - 書き込む文字数

例外:

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

flush

public void flush()
           throws IOException

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

定義:

インタフェース Flushable 内の flush

定義:

クラス Writer 内の flush

例外:

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

close

public void close()
           throws IOException

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

定義:

インタフェース Closeable 内の close

定義:

クラス Writer 内の close

例外:

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