java.io
クラス PrintStream

java.lang.Object
  |
  +--java.io.OutputStream
        |
        +--java.io.FilterOutputStream
              |
              +--java.io.PrintStream

直系の既知のサブクラス:

LogStream

public class PrintStream

extends FilterOutputStream

ほかの出力ストリームに機能を追加します。具体的には、さまざまなデータ値の表現を簡易的に出力する機能を追加します。同様に、ほかの 2 つの機能も提供されています。PrintStream はほかの出力ストリームとは違って、IOException をスローすることはありません。例外的な状況では、単に内部フラグが設定されるだけです。このフラグの状態は、checkError メソッドで調べることができます。必要に応じて、PrintStream を自動的にフラッシュするように作成できます。つまり、バイト配列が書き込まれたか、println メソッドの 1 つが呼び出されたか、または改行文字またはバイト ('¥n') が書き込まれたあとに、flush メソッドが自動的に呼び出されます。

PrintStream が出力したすべての文字は、プラットフォームのデフォルトの文字エンコーディングを使ってバイトに変換されます。PrintWriter クラスは、バイトではなく文字を書き込むことが必要な状況で使用されます。

導入されたバージョン:

JDK1.0

フィールドの概要

クラス java.io.FilterOutputStream から継承したフィールド

out

コンストラクタの概要

PrintStream(OutputStream out)
新しい PrintStream を作成します。

PrintStream(OutputStream out, boolean autoFlush)
新しい PrintStream を作成します。

PrintStream(OutputStream out, boolean autoFlush, String encoding)
新しい PrintStream を作成します。

メソッドの概要

boolean	checkError() ストリームをフラッシュし、そのエラー状況を確認します。
void	close() ストリームを閉じます。
void	flush() ストリームをフラッシュします。
void	print(boolean b) boolean 値を出力します。
void	print(char c) 文字を出力します。
void	print(char[] s) 文字の配列を出力します。
void	print(double d) 倍精度浮動小数点数を出力します。
void	print(float f) 浮動小数点数を出力します。
void	print(int i) 整数を出力します。
void	print(long l) long 整数を出力します。
void	print(Object obj) オブジェクトを出力します。
void	print(String s) 文字列を出力します。
void	println() 行区切り文字列を書き込むことによって、現在の行を終了します。
void	println(boolean x) boolean 値を出力して、行を終了します。
void	println(char x) 文字を出力して、行を終了します。
void	println(char[] x) 文字の配列を出力して、行を終了します。
void	println(double x) double 値を出力して、行を終了します。
void	println(float x) float 値を出力して、行を終了します。
void	println(int x) 整数値を出力して、行を終了します。
void	println(long x) long 値を出力して、行を終了します。
void	println(Object x) Object を出力して、行を終了します。
void	println(String x) String を出力して、行を終了します。
protected void	setError() ストリームのエラー状態を true に設定します。
void	write(byte[] buf, int off, int len) オフセット off から始まる指定のバイト配列から、このストリームに len バイトを書き込みます。
void	write(int b) 指定されたバイトをこのストリームに書き込みます。

クラス java.io.FilterOutputStream から継承したメソッド

write

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

PrintStream

public PrintStream(OutputStream out)

新しい PrintStream を作成します。このストリームは、自動的にフラッシュすることはありません。

パラメータ:

out - 値とオブジェクトが出力される出力ストリーム

関連項目:

PrintWriter.PrintWriter(java.io.OutputStream)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush)

新しい PrintStream を作成します。

パラメータ:

out - 値とオブジェクトが出力される出力ストリーム

autoFlush - boolean 値。true の場合、バイト配列が書き込まれたとき、println メソッドの 1 つが呼び出されたとき、または改行文字またはバイト ('¥n') が書き込まれたときに、出力バッファがフラッシュされる

関連項目:

PrintWriter.PrintWriter(java.io.OutputStream, boolean)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush,
                   String encoding)
            throws UnsupportedEncodingException

新しい PrintStream を作成します。

パラメータ:

out - 値とオブジェクトが出力される出力ストリーム

autoFlush - boolean 値。true の場合、バイト配列が書き込まれたとき、println メソッドの 1 つが呼び出されたとき、または改行文字またはバイト ('¥n') が書き込まれたときに、出力バッファがフラッシュされる

encoding - サポートされる「文字エンコーディング」の名前

例外:

UnsupportedEncodingException - 指定された文字エンコーディングがサポートされていない場合

メソッドの詳細

flush

public void flush()

ストリームをフラッシュします。バッファされた出力バイトを基本となる出力ストリームに書き込み、このストリームをフラッシュします。

オーバーライド:

クラス FilterOutputStream 内の flush

関連項目:

OutputStream.flush()

close

public void close()

ストリームを閉じます。ストリームをフラッシュし、基本となる出力ストリームを閉じます。

オーバーライド:

クラス FilterOutputStream 内の close

関連項目:

OutputStream.close()

checkError

public boolean checkError()

ストリームをフラッシュし、そのエラー状況を確認します。基本となる出力ストリームが InterruptedIOException ではなく IOException をスローする場合、および setError メソッドが呼び出された場合は、内部エラー状態は true に設定されます。基本となる出力ストリームのオペレーションが InterruptedIOException をスローすると、PrintStream が次の操作またはそれに相当する操作によって例外を変換して割り込みに戻します。

     Thread.currentThread().interrupt();
 

戻り値:

このストリームが InterruptedIOException ではなく IOException を検出した場合、または setError メソッドが呼び出された場合は true

setError

protected void setError()

ストリームのエラー状態を true に設定します。

導入されたバージョン:

JDK1.1

write

public void write(int b)

指定されたバイトをこのストリームに書き込みます。バイトが復帰改行で、自動フラッシュが有効な場合は、flush メソッドが呼び出されます。

バイトは、指定されたまま書き込まれることに注意してください。プラットフォームのデフォルトの文字エンコーディングに従って変換された文字を書き込むには、print(char) または println(char) メソッドを使用します。

オーバーライド:

クラス FilterOutputStream 内の write

パラメータ:

b - 書き込まれるバイト

関連項目:

print(char), println(char)

write

public void write(byte[] buf,
                  int off,
                  int len)

オフセット off から始まる指定のバイト配列から、このストリームに len バイトを書き込みます。自動フラッシュが有効な場合は、flush メソッドが呼び出されます。

バイトは、指定されたまま書き込まれます。プラットフォームのデフォルトの文字エンコーディングに従って変換された文字列を書き込むには、print(char) メッソドまたは println(char) メソッドを使用します。

オーバーライド:

クラス FilterOutputStream 内の write

パラメータ:

buf - バイト配列

off - バイトの取り込み開始オフセット

len - 書き込まれるバイト数

関連項目:

FilterOutputStream.write(int)

print

public void print(boolean b)

boolean 値を出力します。String.valueOf(boolean) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

b - 出力される boolean 値

print

public void print(char c)

文字を出力します。文字はプラットフォームのデフォルトの文字エンコーディングに従って 1 つ以上のバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

c - 出力される char 値

print

public void print(int i)

整数を出力します。String.valueOf(int) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

i - 出力される int 値

関連項目:

Integer.toString(int)

print

public void print(long l)

long 整数を出力します。String.valueOf(long) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

l - 出力される long 値

関連項目:

Long.toString(long)

print

public void print(float f)

浮動小数点数を出力します。String.valueOf(float) により作成された文字列はプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

f - 出力される float 値

関連項目:

Float.toString(float)

print

public void print(double d)

倍精度浮動小数点数を出力します。String.valueOf(double) により作成された文字列はプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

d - 出力される double 値

関連項目:

Double.toString(double)

print

public void print(char[] s)

文字の配列を出力します。いくつかの文字列がプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

s - 出力される char の配列

例外:

NullPointerException - s が null の場合

print

public void print(String s)

文字列を出力します。引数が null の場合は、"null" が出力されます。そうでない場合、文字列の各文字はプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

s - 出力される String 値

print

public void print(Object obj)

オブジェクトを出力します。String.valueOf(Object) メソッドにより作成された文字列はプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。

パラメータ:

obj - 出力される Object 値

関連項目:

Object.toString()

println

public void println()

行区切り文字列を書き込むことによって、現在の行を終了します。この行区切り文字列はシステムプロパティ line.separator により定義され、必ずしも単一の改行文字 ('¥n') である必要はありません。

println

public void println(boolean x)

boolean 値を出力して、行を終了します。このメソッドは、print(boolean) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される boolean 値

println

public void println(char x)

文字を出力して、行を終了します。このメソッドは、print(char) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される char 値

println

public void println(int x)

整数値を出力して、行を終了します。このメソッドは、print(int) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される int 値

println

public void println(long x)

long 値を出力して、行を終了します。このメソッドは、print(long) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される long 値

println

public void println(float x)

float 値を出力して、行を終了します。このメソッドは、print(float) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される float 値

println

public void println(double x)

double 値を出力して、行を終了します。このメソッドは、print(double) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される double 値

println

public void println(char[] x)

文字の配列を出力して、行を終了します。このメソッドは、print(char[]) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される char の配列

println

public void println(String x)

String を出力して、行を終了します。このメソッドは、print(String) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される String 値

println

public void println(Object x)

Object を出力して、行を終了します。このメソッドは、print(Object) を呼び出してから println() を呼び出すのと同じように動作します。

パラメータ:

x - 出力される Object 値