java.io
クラス PrintWriter

java.lang.Object
  java.io.Writer
      java.io.PrintWriter

public class PrintWriter
extends Writer

オブジェクトの書式付き表現をテキスト出力ストリームに出力します。このクラスは、PrintStream にある print メソッドをすべて実装します。ただし、raw バイトを書き込むメソッドは含まれません。raw バイトに対しては、エンコードされていないバイトストリームをプログラムで使用してください。

PrintStream クラスとは異なり、自動フラッシュが有効な場合は、改行文字が出力されるときではなく、println() メソッド の 1 つが呼び出されたときにのみ実行されます。println() メソッドは、改行文字ではなく、プラットフォームに固有の行区切りの表記を使用します。

このクラスのメソッドは、入出力例外をスローすることはありません。クライアントは、checkError() を呼び出すことによって、エラーが発生したかどうかを照会できます。

導入されたバージョン:

JDK1.1

フィールドの概要

protected Writer

out この PrintWriter の基本となる文字出力ストリームです。

クラス java.io.Writer から継承されたフィールド

lock

コンストラクタの概要

PrintWriter(OutputStream out)
行の自動フラッシュは行わずに、既存の OutputStream から新しい PrintWriter を作成します。

PrintWriter(OutputStream out, boolean autoFlush)
既存の OutputStream から新しい PrintWriter を作成します。

PrintWriter(Writer out)
自動行フラッシュは行わずに、新しい PrintWriter を作成します。

PrintWriter(Writer out, boolean autoFlush)
新しい PrintWriter を作成します。

メソッドの概要

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) 倍精度浮動小数点数を出力し、行を終了させます。
void	println(float x) 浮動小数点数を出力し、行を終了させます。
void	println(int x) 整数を出力して、行を終了します。
void	println(long x) long 整数値を出力し、行を終了させます。
void	println(Object x) Object を出力して、行を終了します。
void	println(String x) String を出力して、行を終了します。
protected void	setError() エラーが発生したことを示します。
void	write(char[] buf) 文字の配列を書き込みます。
void	write(char[] buf, int off, int len) 文字の配列の一部を書き込みます。
void	write(int c) 単一の文字を書き込みます。
void	write(String s) 文字列を書き込みます。
void	write(String s, int off, int len) 文字列の一部を書き込みます。

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

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

フィールドの詳細

out

protected Writer out

この PrintWriter の基本となる文字出力ストリームです。

導入されたバージョン:

1.2

コンストラクタの詳細

PrintWriter

public PrintWriter(Writer out)

自動行フラッシュは行わずに、新しい PrintWriter を作成します。

パラメータ:

out - 文字出力ストリーム

PrintWriter

public PrintWriter(Writer out,
                   boolean autoFlush)

新しい PrintWriter を作成します。

パラメータ:

out - 文字出力ストリーム

autoFlush - boolean 値。値が true の場合、println() メソッドでは出力バッファーをフラッシュする

PrintWriter

public PrintWriter(OutputStream out)

行の自動フラッシュは行わずに、既存の OutputStream から新しい PrintWriter を作成します。この簡易コンストラクタは、必要となる中間の OutputStreamWriter を作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。

パラメータ:

out - 出力ストリーム

関連項目:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(OutputStream out,
                   boolean autoFlush)

既存の OutputStream から新しい PrintWriter を作成します。この簡易コンストラクタは、必要となる中間の OutputStreamWriter を作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。

パラメータ:

out - 出力ストリーム

autoFlush - boolean 値。値が true の場合、println() メソッドでは出力バッファーをフラッシュする

関連項目:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

メソッドの詳細

flush

public void flush()

ストリームをフラッシュします。

定義:

クラス Writer 内の flush

関連項目:

checkError()

close

public void close()

ストリームを閉じます。

定義:

クラス Writer 内の close

関連項目:

checkError()

checkError

public boolean checkError()

ストリームが閉じていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。エラーは累積されます。ストリームがエラーを一度検出すると、このルーチンは、連続するすべての呼び出しで true を返し続けます。

戻り値:

基本となる出力ストリームで、または形式変換中に、出力ストリームでエラーが検出された場合は true

setError

protected void setError()

エラーが発生したことを示します。

write

public void write(int c)

単一の文字を書き込みます。

オーバーライド:

クラス Writer 内の write

パラメータ:

c - 書き込む文字を指定する int

write

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

文字の配列の一部を書き込みます。

定義:

クラス Writer 内の write

パラメータ:

buf - 文字の配列

off - 文字の書き込み開始オフセット

len - 書き込む文字数

write

public void write(char[] buf)

文字の配列を書き込みます。入出力例外を抑制しなければならないので、このメソッドを Writer クラスから継承することはできません。

オーバーライド:

クラス Writer 内の write

パラメータ:

buf - 書き込む文字の配列

write

public void write(String s,
                  int off,
                  int len)

文字列の一部を書き込みます。

オーバーライド:

クラス Writer 内の write

パラメータ:

s - 文字列

off - 文字の書き込み開始オフセット

len - 書き込む文字数

write

public void write(String s)

文字列を書き込みます。入出力例外を抑制しなければならないので、このメソッドを Writer クラスから継承することはできません。

オーバーライド:

クラス Writer 内の write

パラメータ:

s - 書き込まれる文字列

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)

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

パラメータ:

x - 出力される float 値

println

public void println(double x)

倍精度浮動小数点数を出力し、行を終了させます。このメソッドは、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 値