JavaTM 2
Platform
Std. Ed. v1.4.0

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
関連項目:
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 - snull の場合

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

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.