JavaTM 2 Platform
Std. Ed. v1.3

java.io
クラス OutputStream

java.lang.Object
  |
  +--java.io.OutputStream
直系の既知のサブクラス:
ByteArrayOutputStream, FileOutputStream, FilterOutputStream, ObjectOutputStream, OutputStream, PipedOutputStream

public abstract class OutputStream
extends Object

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

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) の効果は 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 の汎用規約では、それまでに書き込まれたバイトが出力ストリームの実装によってバッファに入れられている場合に flush を呼び出すと、それらのバイトはただちにその目的の転送先に書き込まれます。

OutputStreamflush メソッドは何も行いません。

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

close

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

OutputStreamclose メソッドは何も行いません。

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

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.