- java.lang.Object
-
- java.io.OutputStream
-
- すべての実装されたインタフェース:
Closeable
,Flushable
,AutoCloseable
- 直系の既知のサブクラス:
ByteArrayOutputStream
,FileOutputStream
,FilterOutputStream
,ObjectOutputStream
,OutputStream
,PipedOutputStream
public abstract class OutputStream extends Object implements Closeable, Flushable
この抽象クラスは、バイト出力ストリームを表現するすべてのクラスのスーパー・クラスです。 出力ストリームは、出力バイトを受け付けて、特定の受け手に送ります。OutputStream
のサブクラスを定義する必要のあるアプリケーションでは、少なくとも1バイトの出力を書き込むメソッドを必ず提供しなければなりなせん。- 導入されたバージョン:
- 1.0
- 関連項目:
BufferedOutputStream
,ByteArrayOutputStream
,DataOutputStream
,FilterOutputStream
,InputStream
,write(int)
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 OutputStream()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 void
close()
出力ストリームを閉じ、このストリームに関連するすべてのシステム・リソースを解放します。void
flush()
出力ストリームをフラッシュして、バッファリングされていたすべての出力バイトを強制的に書き込みます。void
write(byte[] b)
指定されたバイト配列のb.length
バイトをこの出力ストリームに書き込みます。void
write(byte[] b, int off, int len)
指定されたバイト配列のオフセット位置off
から始まるlen
バイトをこの出力ストリームに書き込みます。abstract void
write(int b)
指定されたバイトをこの出力ストリームに書き込みます。
-
-
-
メソッドの詳細
-
write
public abstract void write(int b) throws IOException
指定されたバイトをこの出力ストリームに書き込みます。write
の汎用規約では、1バイトが出力ストリームに書き込まれます。 書き込まれるバイトは、引数b
の下位8ビットです。b
の上位24ビットは無視されます。OutputStream
のサブクラスは、このメソッドの実装を提供しなければなりません。- パラメータ:
b
-byte
。- 例外:
IOException
- 入出力エラーが発生した場合。 特に、出力ストリームが閉じられた場合は、IOException
がスローされる可能性がある。
-
write
public void write(byte[] b) throws IOException
指定されたバイト配列のb.length
バイトをこの出力ストリームに書き込みます。write(b)
の汎用規約では、write(b, 0, b.length)
を呼び出したときと同じ動作を行います。- パラメータ:
b
- データ。- 例外:
IOException
- 入出力エラーが発生した場合。- 関連項目:
write(byte[], int, int)
-
write
public void write(byte[] b, int off, int len) throws IOException
指定されたバイト配列のオフセット位置off
から始まるlen
バイトをこの出力ストリームに書き込みます。write(b, off, len)
の汎用規約では、配列b
内の一定のバイトが出力ストリームに順番に書き込まれます。この処理で最初に書き込まれるバイトは要素b[off]
、最後に書き込まれるバイトは要素b[off+len-1]
です。OutputStream
のwrite
メソッドは、書き込むバイトごとに1個の引数を持つ書込みメソッドを呼び出します。 サブクラスでは、このメソッドをオーバーライドし、より効率的に実装してください。b
がnull
の場合、NullPointerException
がスローされます。off
が負の場合、len
が負の場合、またはoff+len
が配列b
の長さよりも大きい場合は、IndexOutOfBoundsException
がスローされます。- パラメータ:
b
- データ。off
- データの開始オフセット。len
- 書き込むバイト数。- 例外:
IOException
- 入出力エラーが発生した場合。 特に、出力ストリームが閉じられると、IOException
がスローされる。
-
flush
public void flush() throws IOException
出力ストリームをフラッシュして、バッファリングされていたすべての出力バイトを強制的に書き込みます。flush
の汎用規約では、それまでに書き込まれたバイトが出力ストリームの実装によってバッファに入れられている場合に呼び出すと、それらのバイトはただちにその目的の転送先に書き込まれます。このストリームの目的の転送先が、ベースとなるオペレーティング・システムによって提供される抽象化オブジェクト(ファイルなど)である場合、ストリームをフラッシュすることで、それまでにストリームに書き込まれたバイトがオペレーティング・システムに渡されて書き込まれることは保証されますが、ディスク・ドライブなどの物理デバイスに実際に書き込まれることは保証されません。
OutputStream
のflush
メソッドは何も行いません。- 定義:
flush
、インタフェース:Flushable
- 例外:
IOException
- 入出力エラーが発生した場合。
-
close
public void close() throws IOException
出力ストリームを閉じ、このストリームに関連するすべてのシステム・リソースを解放します。close
の汎用規約では、出力ストリームを閉じます。 閉じられたストリームは入出力処理を実行できません。また、閉じられたストリームを開き直すことはできません。OutputStream
のclose
メソッドは何も行いません。- 定義:
close
、インタフェース:AutoCloseable
- 定義:
close
、インタフェース:Closeable
- 例外:
IOException
- 入出力エラーが発生した場合。
-
-