JavaTM Platform
Standard Ed. 6

java.io
クラス OutputStream

java.lang.Object
  上位を拡張 java.io.OutputStream
すべての実装されたインタフェース:
Closeable, Flushable
直系の既知のサブクラス:
ByteArrayOutputStream, FileOutputStream, FilterOutputStream, ObjectOutputStream, OutputStream, PipedOutputStream

public abstract class OutputStream
extends Object
implements Closeable, Flushable

この abstract クラスは、バイト出力ストリームを表現するすべてのクラスのスーパークラスです。出力ストリームは、出力バイトを受け付けて、特定の受け手に送ります。

OutputStream のサブクラスを定義する必要のあるアプリケーションでは、少なくとも 1 バイトの出力を書き込むメソッドを必ず提供しなければなりなせん。

導入されたバージョン:
JDK1.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)
          指定されたバイトをこの出力ストリームに書き込みます。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

OutputStream

public OutputStream()
メソッドの詳細

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] です。

OutputStreamwrite メソッドは、書き込むバイトごとに 1 個の引数を持つ書き込みメソッドを呼び出します。サブクラスでは、このメソッドをオーバーライドし、より効率的に実装してください。

bnull の場合は、NullPointerException がスローされます。

off が負の場合、len が負の場合、あるいは off+len が配列 b の長さより大きい場合は、IndexOutOfBoundsException がスローされます。

パラメータ:
b - データ
off - データの開始オフセット
len - 書き込むバイト数
例外:
IOException - 入出力エラーが発生した場合特に、出力ストリームが閉じられると、IOException がスローされる

flush

public void flush()
           throws IOException
出力ストリームをフラッシュして、バッファリングされていたすべての出力バイトを強制的に書き込みます。flush の汎用規約では、それまでに書き込まれたバイトが出力ストリームの実装によってバッファーに入れられている場合に呼び出すと、それらのバイトはただちにその目的の転送先に書き込まれます。

このストリームの目的の転送先が、基本となるオペレーティングシステムによって提供される抽象化オブジェクト (ファイルなど) である場合、ストリームをフラッシュすることで、それまでにストリームに書き込まれたバイトがオペレーティングシステムに渡されて書き込まれることは保証されますが、ディスクドライブなどの物理デバイスに実際に書き込まれることは保証されません。

定義:
インタフェース Flushable 内の flush
例外:
IOException - 入出力エラーが発生した場合

close

public void close()
           throws IOException
出力ストリームを閉じ、このストリームに関連するすべてのシステムリソースを解放します。close の汎用規約では、出力ストリームを閉じます。閉じられたストリームは入出力処理を実行できません。また、閉じられたストリームを開き直すことはできません。

定義:
インタフェース Closeable 内の close
例外:
IOException - 入出力エラーが発生した場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。