|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Objectjava.io.Writer
java.io.PrintWriter
public class PrintWriter
フォーマットされたオブジェクトの表現をテキスト出力ストリームに出力します。このクラスでは、PrintStream にある print メソッドをすべて実装しています。ただし、生のバイトを書き込むメソッドは含みません。このような場合は、エンコードされていないバイトストリームをプログラムで使用しなければなりません。
自動フラッシュが有効な場合は、PrintStream とは違い、改行文字を出力するときではなく、println、printf、または format メソッドの 1 つを呼び出したときにフラッシュが行われます。これらのメソッドでは、改行文字ではなく、そのプラットフォーム自体が持つ行区切り文字の表記を使用します。
このクラスのメソッドは、入出力例外をスローすることはありませんが、コンストラクタの中にはスローするものもあります。クライアントは、checkError() を呼び出すことによって、エラーが発生したかどうかを照会できます。
| フィールドの概要 | |
|---|---|
protected Writer |
out
この PrintWriter の基本となる文字出力ストリームです。 |
| クラス java.io.Writer から継承されたフィールド |
|---|
lock |
| コンストラクタの概要 | |
|---|---|
PrintWriter(File file)
行の自動フラッシュは行わずに、指定のファイルで 新しい PrintWriter を作成します。 |
|
PrintWriter(File file,
String csn)
行の自動フラッシュは行わずに、指定のファイルと文字セットで 新しい PrintWriter を作成します。 |
|
PrintWriter(OutputStream out)
行の自動フラッシュは行わずに、既存の OutputStream から新しい PrintWriter を作成します。 |
|
PrintWriter(OutputStream out,
boolean autoFlush)
既存の OutputStream から新しい PrintWriter を作成します。 |
|
PrintWriter(String fileName)
行の自動フラッシュは行わずに、指定の名前で 新しい PrintWriter を作成します。 |
|
PrintWriter(String fileName,
String csn)
行の自動フラッシュは行わずに、指定の名前と文字セットで 新しい PrintWriter を作成します。 |
|
PrintWriter(Writer out)
自動行フラッシュは行わずに、新しい PrintWriter を作成します。 |
|
PrintWriter(Writer out,
boolean autoFlush)
新しい PrintWriter を作成します。 |
|
| メソッドの概要 | |
|---|---|
PrintWriter |
append(char c)
このライターに指定された文字を追加します。 |
PrintWriter |
append(CharSequence csq)
このライターに指定された文字シーケンスを追加します。 |
PrintWriter |
append(CharSequence csq,
int start,
int end)
指定された文字シーケンスのサブシーケンスをこのライターに追加します。 |
boolean |
checkError()
ストリームが閉じていなければフラッシュし、そのエラーの状態をチェックします。 |
void |
close()
ストリームを閉じます。 |
void |
flush()
ストリームをフラッシュします。 |
PrintWriter |
format(Locale l,
String format,
Object... args)
書式付き文字列を、指定された書式文字列と引数を使用し、このライターに書き込みます。 |
PrintWriter |
format(String format,
Object... args)
書式付き文字列を、指定された書式文字列と引数を使用し、このライターに書き込みます。 |
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)
文字列を出力します。 |
PrintWriter |
printf(Locale l,
String format,
Object... args)
書式付き文字列を、指定された書式文字列と引数を使用し、このライターに書き込む便利な方法です。 |
PrintWriter |
printf(String format,
Object... args)
書式付き文字列を、指定された書式文字列と引数を使用し、このライターに書き込む便利な方法です。 |
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 |
| フィールドの詳細 |
|---|
protected Writer out
PrintWriter の基本となる文字出力ストリームです。
| コンストラクタの詳細 |
|---|
public PrintWriter(Writer out)
out - 文字出力ストリーム
public PrintWriter(Writer out,
boolean autoFlush)
out - 文字出力ストリームautoFlush - boolean 値。値が true の場合、println、printf、または format メソッドでは出力バッファをフラッシュするpublic PrintWriter(OutputStream out)
out - 出力ストリームOutputStreamWriter.OutputStreamWriter(java.io.OutputStream)
public PrintWriter(OutputStream out,
boolean autoFlush)
out - 出力ストリームautoFlush - boolean 値。値が true の場合、println、printf、または format メソッドでは出力バッファをフラッシュするOutputStreamWriter.OutputStreamWriter(java.io.OutputStream)
public PrintWriter(String fileName)
throws FileNotFoundException
OutputStreamWriter を作成します。これにより、この Java 仮想マシンのこのインスタンスの default charset を使って文字をエンコードします。
fileName - このライターの宛先として使用するファイルの名前。ファイルが存在する場合、サイズ 0 に切り捨てられる。ファイルがなければ新しいファイルが作成される。出力はファイルに書き込まれ、バッファに格納される
FileNotFoundException - 指定の文字列が、既存の書き込み可能な普通のファイルを示さず、その名前を持つ普通のファイルを作成できない場合。またはファイルを開いているときや作成しているときに、その他のエラーが発生した場合
SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkWrite(fileName) メソッドがファイルへの書き込みアクセスを許可しない場合
public PrintWriter(String fileName,
String csn)
throws FileNotFoundException,
UnsupportedEncodingException
OutputStreamWriter を作成します。これにより、指定の文字セットを使って文字をエンコードします。
fileName - このライターの宛先として使用するファイルの名前。ファイルが存在する場合、サイズ 0 に切り捨てられる。ファイルがなければ新しいファイルが作成される。出力はファイルに書き込まれ、バッファに格納されるcsn - サポートする charset の名前
FileNotFoundException - 指定の文字列が、既存の書き込み可能な普通のファイルを示さず、その名前を持つ普通のファイルを作成できない場合。またはファイルを開いているときや作成しているときに、その他のエラーが発生した場合
SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkWrite(fileName) メソッドがファイルへの書き込みアクセスを許可しない場合
UnsupportedEncodingException - 指定された文字セットがサポートされていない場合
public PrintWriter(File file)
throws FileNotFoundException
OutputStreamWriter を作成します。これにより、この Java 仮想マシンのこのインスタンスの default charset を使って文字をエンコードします。
file - このライターの宛先として使用するファイル。ファイルが存在する場合、サイズ 0 に切り捨てられる。ファイルがなければ新しいファイルが作成される。出力はファイルに書き込まれ、バッファに格納される
FileNotFoundException - 指定のファイルオブジェクトが、既存の書き込み可能な普通のファイルを示さず、その名前を持つ普通のファイルを作成できない場合。またはファイルを開いているときや作成しているときに、その他のエラーが発生した場合
SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkWrite(file.getPath()) メソッドがファイルへの書き込みアクセスを許可しない場合
public PrintWriter(File file,
String csn)
throws FileNotFoundException,
UnsupportedEncodingException
OutputStreamWriter を作成します。これにより、指定の文字セットを使って文字をエンコードします。
file - このライターの宛先として使用するファイル。ファイルが存在する場合、サイズ 0 に切り捨てられる。ファイルがなければ新しいファイルが作成される。出力はファイルに書き込まれ、バッファに格納されるcsn - サポートする charset の名前
FileNotFoundException - 指定のファイルオブジェクトが、既存の書き込み可能な普通のファイルを示さず、その名前を持つ普通のファイルを作成できない場合。またはファイルを開いているときや作成しているときに、その他のエラーが発生した場合
SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkWrite(file.getPath()) メソッドがファイルへの書き込みアクセスを許可しない場合
UnsupportedEncodingException - 指定された文字セットがサポートされていない場合| メソッドの詳細 |
|---|
public void flush()
Flushable 内の flushWriter 内の flushcheckError()public void close()
Closeable 内の closeWriter 内の closecheckError()public boolean checkError()
protected void setError()
public void write(int c)
Writer 内の writec - 書き込む文字を指定する int
public void write(char[] buf,
int off,
int len)
Writer 内の writebuf - 文字の配列off - 文字の書き込み開始オフセットlen - 書き込む文字数public void write(char[] buf)
Writer 内の writebuf - 書き込む文字の配列
public void write(String s,
int off,
int len)
Writer 内の writes - 文字列off - 文字の書き込み開始オフセットlen - 書き込む文字数public void write(String s)
Writer 内の writes - 書き込まれる文字列public void print(boolean b)
String.valueOf(boolean) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
b - 出力される boolean 値public void print(char c)
write(int) メソッドとまったく同じ方法で書き込まれます。
c - 出力される char 値public void print(int i)
String.valueOf(int) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
i - 出力される int 値Integer.toString(int)public void print(long l)
String.valueOf(long) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
l - 出力される long 値Long.toString(long)public void print(float f)
String.valueOf(float) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
f - 出力される float 値Float.toString(float)public void print(double d)
String.valueOf(double) により作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
d - 出力される double 値Double.toString(double)public void print(char[] s)
write(int) メソッドとまったく同じ方法で書き込まれます。
s - 出力される char の配列
NullPointerException - s が null の場合public void print(String s)
null の場合は、"null" が出力されます。そうでない場合、文字列の各文字はプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
s - 出力される String 値public void print(Object obj)
String.valueOf(Object) メソッドにより作成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
obj - 出力される Object 値Object.toString()public void println()
line.separator プロパティにより定義され、必ずしも単一の改行文字 ('\n') であるとは限りません。
public void println(boolean x)
print(boolean) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される boolean 値public void println(char x)
print(char) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される char 値public void println(int x)
print(int) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される int 値public void println(long x)
print(long) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される long 値public void println(float x)
print(float) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される float 値public void println(double x)
print(double) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される double 値public void println(char[] x)
print(char[]) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される char の配列public void println(String x)
print(String) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される String 値public void println(Object x)
#print(object) を呼び出してから println() を呼び出すのと同じように動作します。
x - 出力される Object 値
public PrintWriter printf(String format,
Object... args)
このメソッドを out.printf(format, args) の形式で呼び出した場合、次の呼び出しと同じ結果が得られます。
out.format(format, args)
format - 「書式文字列の構文」で説明した書式文字列args - 書式文字列の書式指示子により参照される引数。書式指示子よりも引数が多い場合、余分な引数は無視される。引数の数は変動し、ゼロの場合もある。引数の最大値は、『Java 仮想マシン仕様』で定義されている Java 配列の最大次元により制限される。null 引数での動作は、変換に応じて異なる
IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に与えられた不適切な引数、あるいは他の不正な条件を含む場合。考えられるすべての書式エラーの仕様については、フォーマッタクラス仕様の「詳細」セクションを参照
NullPointerException - format が null の場合
public PrintWriter printf(Locale l,
String format,
Object... args)
このメソッドを out.printf(l, format, args) の形式で呼び出した場合、次の呼び出しと同じ結果が得られます。
out.format(l, format, args)
l - 書式設定時に適用する locale。l が null の場合、地域対応は適用されないformat - 「書式文字列の構文」で説明した書式文字列args - 書式文字列の書式指示子により参照される引数。書式指示子よりも引数が多い場合、余分な引数は無視される。引数の数は変動し、ゼロの場合もある。引数の最大値は、『Java 仮想マシン仕様』で定義されている Java 配列の最大次元により制限される。null 引数での動作は、変換に応じて異なる
IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に与えられた不適切な引数、あるいは他の不正な条件を含む場合。考えられるすべての書式エラーの仕様については、フォーマッタクラス仕様の「詳細」セクションを参照
NullPointerException - format が null の場合
public PrintWriter format(String format,
Object... args)
常に使用されるロケールは、このオブジェクトのその他の書式化メソッドのこれまでの呼び出しに関係なく、Locale.getDefault() により返されるロケールです。
format - 「書式文字列の構文」で説明した書式文字列args - 書式文字列の書式指示子により参照される引数。書式指示子よりも引数が多い場合、余分な引数は無視される。引数の数は変動し、ゼロの場合もある。引数の最大値は、『Java 仮想マシン仕様』で定義されている Java 配列の最大次元により制限される。null 引数での動作は、変換に応じて異なる
IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性のない書式指示子、書式文字列に与えられた不適切な引数、あるいは他の不正な条件を含む場合。考えられるすべての書式エラーの仕様については、フォーマッタクラス仕様の「詳細」セクションを参照
NullPointerException - format が null の場合
public PrintWriter format(Locale l,
String format,
Object... args)
l - 書式設定時に適用するlocale。l が null の場合、地域対応は適用されないformat - 「書式文字列の構文」で説明した書式文字列args - 書式文字列の書式指示子により参照される引数。書式指示子よりも引数が多い場合、余分な引数は無視される。引数の数は変動し、ゼロの場合もある。引数の最大値は、『Java 仮想マシン仕様』で定義されている Java 配列の最大次元により制限される。null 引数での動作は、変換に応じて異なる
IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に与えられた不適切な引数、あるいは他の不正な条件を含む場合。考えられるすべての書式エラーの仕様については、フォーマッタクラス仕様の「詳細」セクションを参照
NullPointerException - format が null の場合public PrintWriter append(CharSequence csq)
このメソッドを out.append(csq) の形式で呼び出した場合、次の呼び出しと同じ結果が得られます。
out.write(csq.toString())
文字シーケンス csq に対する toString の指定に応じて、シーケンス全体が追加されないこともあります。たとえば、文字バッファの toString を呼び出すと、内容がバッファの位置とリミットに依存するサブシーケンスが返されます。
Appendable 内の appendWriter 内の appendcsq - 追加される文字シーケンス。csq が null の場合は、このライターに「null」という 4 文字が追加される
public PrintWriter append(CharSequence csq,
int start,
int end)
csq が null ではないときに、このメソッドを out.append(csq, start, end) の形式で呼び出した場合、次の呼び出しと同じ結果が得られます。
out.write(csq.subSequence(start, end).toString())
Appendable 内の appendWriter 内の appendcsq - サブシーケンスの追加元の文字シーケンス。csq が null であれば、文字は csq に「null」という 4 文字が含まれているかのように追加されるstart - サブシーケンスの最初の文字のインデックスend - サブシーケンスの最後の文字のあとに続く文字のインデックス
IndexOutOfBoundsException - start または end が負の値の場合、start が end より大きい場合、あるいは end が csq.length() より大きい場合public PrintWriter append(char c)
このメソッドを out.append(c) の形式で呼び出した場合、次の呼び出しと同じ結果が得られます。
out.write(c)
Appendable 内の appendWriter 内の appendc - 追加される 16 ビットの文字
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。