java.io
クラス PrintWriter

java.lang.Object
  |
  +--java.io.Writer
        |
        +--java.io.PrintWriter

public class PrintWriter

extends Writer

フォーマットされたオブジェクトの表現をテキスト出力ストリームに出力します。このクラスでは、PrintStream にある印字メソッドをすべて実装しています。ただし、生のバイトを書き込むメソッドは含みません。このような場合は、コード化されていないバイトストリームをプログラムで使用しなければなりません。

自動フラッシュが有効な場合は、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

クラス java.io.Writer からコピーされたタグ:

例外:

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

close

public void close()

ストリームを閉じます。

オーバーライド:

クラス Writer 内の close

クラス java.io.Writer からコピーされたタグ:

例外:

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

checkError

public boolean checkError()

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

戻り値:

基本となる出力ストリームで、またはフォーマット変換中に、プリントストリームがエラーを検出した場合は true

setError

protected void setError()

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

write

public void write(int c)

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

オーバーライド:

クラス Writer 内の write

クラス java.io.Writer からコピーされたタグ:

パラメータ:

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

例外:

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

write

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

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

オーバーライド:

クラス Writer 内の write

クラス java.io.Writer からコピーされたタグ:

パラメータ:

cbuf - 文字の配列

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

len - 書き込む文字数

例外:

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

write

public void write(char[] buf)

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

オーバーライド:

クラス Writer 内の write

クラス java.io.Writer からコピーされたタグ:

パラメータ:

cbuf - 書き込む文字の配列

例外:

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

write

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

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

オーバーライド:

クラス Writer 内の write

クラス java.io.Writer からコピーされたタグ:

パラメータ:

str - 文字列

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

len - 書き込む文字数

例外:

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

write

public void write(String s)

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

オーバーライド:

クラス Writer 内の write

クラス java.io.Writer からコピーされたタグ:

パラメータ:

str - 書き込まれる文字列

例外:

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

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 値