java.io.OutputStream
|
Unofficial "CLDC 1.1 + MIDP 2.0" API Reference. （日本語版） |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Object
public abstract class OutputStream
バイト単位で連続的な出力を行う「出力ストリーム」処理を行うすべてのクラスのスーパークラスです。
このクラスは抽象クラスとして宣言されており、write(int) メソッドをサブクラスで実装する必要があります。
InputStream| コンストラクタの概要 | |
|---|---|
OutputStream()
デフォルトのコンストラクタです。 |
|
| メソッドの概要 | |
|---|---|
void |
close()
出力ストリームをクローズし、関連するリソースをすべて開放します。 |
void |
flush()
出力ストリームがバッファリングを行っている場合、そのバッファに格納されているデータを直ちに書き込み先に出力します。 |
void |
write(byte[] data)
出力ストリームへ指定された byte 配列に格納されたデータを書き込みます。 |
void |
write(byte[] data,
int index,
int length)
出力ストリームへ指定バイト数分のデータを指定された byte 配列の指定位置から書き込みます。 |
abstract void |
write(int data)
出力ストリームへデータを 1 バイト書き込みます。 |
| クラス java.lang.Object から継承されたメソッド |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| コンストラクタの詳細 |
|---|
public OutputStream()
| メソッドの詳細 |
|---|
public abstract void write(int data)
throws IOException
出力ストリームへデータを 1 バイト書き込みます。
書き込むデータは int 型で指定しますが、実際に書き込まれるのは下位 8 ビットのみです。
残りの上位 24 ビットは処理に影響しません。
このメソッドはデータの書き込みに終了するか例外が throw されるまでブロックします。
サブクラスではこの規約に従ってこのメソッドを実装しなければなりません。
data - 書き込むデータを渡します。
IOException - データの書き込み時に何らかの障害が発生した場合に throw します。
public void write(byte[] data)
throws IOException
出力ストリームへ指定された byte 配列に格納されたデータを書き込みます。
このメソッドは data.length が示すデータの書き込みが完了するか、例外が throw されるまでブロックします。
このメソッドで例外が throw されるのは以下の場合です。
IOException を throw します。
data が null 場合は NullPointerException が throw されます。
これらの例外が throw された場合でも、そこまでに書き込んだデータは取り消されません。
OutputStream クラスにおけるこのメソッドは、write(data, 0, data.length) と記述するのと等価です。
data - 書き込むデータを格納した byte 配列を渡します。
IOException - データの書き込み時に何らかの障害が発生した場合に throw します。
NullPointerException - data に null が渡された場合に throw します。
public void write(byte[] data,
int index,
int length)
throws IOException
出力ストリームへ指定バイト数分のデータを指定された byte 配列の指定位置から書き込みます。
このメソッドは指定バイト数のデータの書き込みが完了するか、例外が throw されるまでブロックします。
このメソッドで例外が throw されるのは以下の場合です。
IOException を throw します。
index が負数あるいは index + length が data のサイズを超える場合は IndexOutOfBoundsException が throw されます。
data が null 場合は NullPointerException が throw されます。
これらの例外が throw された場合でも、そこまでに書き込んだデータは取り消されません。
OutputStream クラスにおけるこのメソッドは、write(int) メソッドを必要回数呼び出してデータを書き込むように記述されています。
サブクラスでより効率的な処理が可能な場合はオーバーライドして処理を記述すべきです。
data - 書き込むデータを格納した byte 配列を渡します。index - 書き込むデータを格納した byte 配列の書き込み開始位置を渡します。length - 書き込むバイト数を渡します。
IOException - データの書き込み時に何らかの障害が発生した場合に throw します。
NullPointerException - data に null が渡された場合に throw します。
IndexOutOfBoundsException - index が負数あるいは index + length が data のサイズを超える場合に throw します。
public void flush()
throws IOException
出力ストリームがバッファリングを行っている場合、そのバッファに格納されているデータを直ちに書き込み先に出力します。 サブクラスでバッファリングを伴う実装を行う場合はこのメソッドを適切に実装しなければなりません。
OutputStream クラスにおけるこのメソッドは何も処理を行いません。
IOException - 処理に伴い、出力関係で何らかの障害が発生した場合に throw します。
public void close()
throws IOException
出力ストリームをクローズし、関連するリソースをすべて開放します。
OutputStream クラスにおけるこのメソッドは何も処理を行いません。
IOException - 処理に伴い、出力関係で何らかの障害が発生した場合に throw します。
|
Unofficial "CLDC 1.1 + MIDP 2.0" API Reference. （日本語版） |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
| 公式仕様書原文の著作権表記等（※）： Mobile Information Device Profile Specification ("Specification") Version: 2.0 Status: FCS Release: November 5, 2002 Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc. All rights reserved. | ※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。 ※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます（第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います）。 |
