|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.io.Writer java.io.PrintWriter
public class PrintWriter
オブジェクトの書式付き表現をテキスト出力ストリームに出力します。このクラスは、PrintStream
にある print メソッドをすべて実装します。ただし、raw バイトを書き込むメソッドは含まれません。raw バイトに対しては、エンコードされていないバイトストリームをプログラムで使用してください。
PrintStream
クラスとは異なり、自動フラッシュが有効な場合は、改行文字が出力されるときではなく、println、printf、format のいずれかのメソッドが呼び出されたときにのみ実行されます。これらのメソッドは、改行文字ではなく、プラットフォームに固有の行区切りの表記を使用します。
このクラスのメソッドは、コンストラクタの一部を除き、入出力例外をスローすることはありません。クライアントは、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()
ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。 |
protected void |
clearError()
このストリームのエラー状態を解除します。 |
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)
文字列を出力し、行を終了させます。 |
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 仮想マシンインスタンスのデフォルト文字セットを使用して、文字をエンコードします。
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 仮想マシンインスタンスのデフォルト文字セットを使用して、文字をエンコードします。
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
内の flush
Writer
内の flush
checkError()
public void close()
Closeable
内の close
Writer
内の close
checkError()
public boolean checkError()
true
protected void setError()
このメソッドを使用すると、clearError()
が呼び出されるまで、checkError()
が引き続き呼び出されて true が返されます。
protected void clearError()
このメソッドを使用すると、別の書き込み処理が失敗して、setError()
が呼び出されるまで、checkError()
が引き続き呼び出されて false が返されます。
public void write(int c)
Writer
内の write
c
- 書き込む文字を指定する intpublic void write(char[] buf, int off, int len)
Writer
内の write
buf
- 文字の配列off
- 文字の書き込み開始オフセットlen
- 書き込む文字数public void write(char[] buf)
Writer
内の write
buf
- 書き込む文字の配列public void write(String s, int off, int len)
Writer
内の write
s
- 文字列off
- 文字の書き込み開始オフセットlen
- 書き込む文字数public void write(String s)
Writer
内の write
s
- 書き込まれる文字列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(String)
を呼び出してから 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
- 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に与えられた不適切な引数、あるいはほかの不正な条件を含む場合。考えられるすべての書式エラーの仕様については、Formatter クラス仕様の「詳細」セクションを参照
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
内の append
Writer
内の append
csq
- 追加される文字シーケンス。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
内の append
Writer
内の append
csq
- サブシーケンスの追加元の文字シーケンス。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
内の append
Writer
内の append
c
- 追加される 16 ビット文字
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。