java.io
クラス PrintStream

java.lang.Object
  java.io.OutputStream
      java.io.PrintStream

public class PrintStream
extends OutputStream

出力ストリームを受け取り、その出力ストリームに対してさまざまな型のデータの文字列表現を出力する機能を提供するクラスです。 このクラスは他の出力ストリーム系クラスと異なり、出力に失敗した場合でも IOException を throw しません。 通常 IOException クラスが throw されるような状況が発生した場合、このクラスでは内部フラグにその状況を記録します。 アプリケーションは checkError() メソッドを呼び出して、このフラグがセットされているか否かを確認することができます。

CLDC では PrintStream クラスが自動的にバッファをフラッシュするように設定することはできません。

PrintStream は文字の出力時に、プラットフォームがデフォルトで使用する文字エンコーディングを使用します。

導入されたバージョン:

CLDC 1.0

PrintStream

public PrintStream(OutputStream os)

出力ストリームを受け取ってオブジェクトを生成します。

flush

public void flush()

バッファリングしているデータを出力ストリームへ出力し、出力ストリームに対してもフラッシュを実行します。

オーバーライド:

クラス OutputStream 内の flush

close

public void close()

このストリームをクローズします。 まず、バッファリングしているデータを出力ストリームへ出力し、出力ストリームに対してもフラッシュを実行します。 次にこのストリームと出力ストリームをクローズし、関連するリソースを全て開放します。

オーバーライド:

クラス OutputStream 内の close

checkError

public boolean checkError()

このストリームをフラッシュしてからエラーが発生しているか否かを返します。 出力ストリームが IOException を throw していた場合および setError() メソッドが呼び出されていた場合は true を返します。

setError

protected void setError()

このストリームのエラーフラグを立てます。

write

public void write(int data)

保持している出力ストリームへ 1 バイトのデータを書き込みます。 渡された data は文字エンコーディングによる操作を行わずにそのまま書き込みます。 文字エンコーディングによる操作が必要な場合は print(char) メソッドあるいは println(char) メソッドを使用します。

定義:

クラス OutputStream 内の write

パラメータ:

data - 書き込むデータを渡します。

関連項目:

print(char), println(char)

write

public void write(byte[] data,
                  int index,
                  int length)

保持している出力ストリームへ指定バイト数分のデータを指定された byte 配列の指定位置から書き込みます。 書き込まれるデータは文字エンコーディングによる操作を行わずにそのまま書き込みます。

オーバーライド:

クラス OutputStream 内の write

パラメータ:

data - 書き込むデータを格納した byte 配列を渡します。

index - 書き込むデータを格納した byte 配列の書き込み開始位置を渡します。

length - 書き込むバイト数を渡します。

print

public void print(boolean data)

保持している出力ストリームへ渡された boolean 型の値の文字列表現を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む boolean 型の値を渡します。

print

public void print(char data)

保持している出力ストリームへ渡された char 型の値で表現される文字を書き込みます。 書き込まれる文字はデフォルトの文字エンコーディングによる操作を行ってから 1 バイト以上のデータとして書き込みます。

パラメータ:

data - 書き込む対象の文字を渡します。

print

public void print(int data)

保持している出力ストリームへ渡された int 型の値の文字列表現を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む int 型の値を渡します。

print

public void print(long data)

保持している出力ストリームへ渡された long 型の値の文字列表現を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む long 型の値を渡します。

print

public void print(char[] data)

保持している出力ストリームへ渡された char 型の配列による文字列を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む char 型の配列を渡します。

print

public void print(String data)

保持している出力ストリームへ渡された String オブジェクトが保持する文字列を書き込みます。 data が null の場合は"null"が渡されたものとして処理します。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む String オブジェクトを渡します。

print

public void print(Object data)

保持している出力ストリームへ渡されたオブジェクトの文字列表現を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込むオブジェクトを渡します。

println

public void println()

保持している出力ストリームへデフォルトの文字エンコーディングに基づく改行コードを書き込みます。 改行コードは文字エンコーディングによって異なり、必ずしも 1 要素の文字コードであるとは限りません。

println

public void println(boolean data)

保持している出力ストリームへ渡された boolean 型の値の文字列表現を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む boolean 型の値を渡します。

println

public void println(char data)

保持している出力ストリームへ渡された char 型の値で表現される文字を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字はデフォルトの文字エンコーディングによる操作を行ってから 1 バイト以上のデータとして書き込みます。

パラメータ:

data - 書き込む対象の文字を渡します。

println

public void println(int data)

保持している出力ストリームへ渡された int 型の値の文字列表現を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む int 型の値を渡します。

println

public void println(long data)

保持している出力ストリームへ渡された long 型の値の文字列表現を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む long 型の値を渡します。

println

public void println(char[] data)

保持している出力ストリームへ渡された char 型の配列による文字列を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む char 型の配列を渡します。

println

public void println(String data)

保持している出力ストリームへ渡された String オブジェクトが保持する文字列を書き込みます。 data が null の場合は"null"が渡されたものとして処理します。 文字列の書き込み後、改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む String オブジェクトを渡します。

println

public void println(Object data)

保持している出力ストリームへ渡されたオブジェクトの文字列表現を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込むオブジェクトを渡します。

print

public void print(float data)

保持している出力ストリームへ渡された float 型の値の文字列表現を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む float 型の値を渡します。

導入されたバージョン:

CLDC 1.1

print

public void print(double data)

保持している出力ストリームへ渡された double 型の値の文字列表現を書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む double 型の値を渡します。

導入されたバージョン:

CLDC 1.1

println

public void println(float data)

保持している出力ストリームへ渡された float 型の値の文字列表現を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む float 型の値を渡します。

導入されたバージョン:

CLDC 1.1

println

public void println(double data)

保持している出力ストリームへ渡された double 型の値の文字列表現を書き込みます。 その後改行コードを書き込みます。 書き込まれる文字列表現はデフォルトの文字エンコーディングによる操作を行ってから保持している出力ストリームへ書き込みます。

パラメータ:

data - 書き込む double 型の値を渡します。

導入されたバージョン:

CLDC 1.1