- すべての実装されたインタフェース:
Closeable,Flushable,Appendable,AutoCloseable
public class PrintWriter extends Writer
PrintStreamで見つかったすべてのprintメソッドを実装します。 ただし、rawバイトを書き込むメソッドは含まれません。rawバイトに対しては、エンコードされていないバイト・ストリームをプログラムで使用してください。
PrintStreamクラスとは異なり、自動フラッシュが有効な場合は、改行文字が出力されるときではなく、println、printf、またはformatのいずれかのメソッドが呼び出されたときにのみ実行されます。 これらのメソッドは、改行文字ではなく、プラットフォームに固有の行区切りの表記を使用します。
このクラスのメソッドは、コンストラクタの一部を除き、入出力例外をスローすることはありません。 クライアントは、checkError()を呼び出すことによって、エラーが発生したかどうかを照会できます。
このクラスは、不正な形式およびマップ不可能な文字列を、常にcharsetのデフォルトの置換文字列で置き換えます。 エンコード処理をより強力に制御する必要がある場合は、CharsetEncoderクラスを使用してください。
- 導入されたバージョン:
- 1.1
-
フィールドのサマリー
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 PrintWriter(File file)行の自動フラッシュは行わずに、指定されたファイルで新しいPrintWriterを作成します。PrintWriter(File file, String csn)行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。PrintWriter(File file, Charset charset)行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。PrintWriter(OutputStream out)行の自動フラッシュは行わずに、既存のOutputStreamから新しいPrintWriterを作成します。PrintWriter(OutputStream out, boolean autoFlush)既存のOutputStreamから新しいPrintWriterを作成します。PrintWriter(OutputStream out, boolean autoFlush, Charset charset)既存のOutputStreamから新しいPrintWriterを作成します。PrintWriter(Writer out)行の自動フラッシュは行わずに、新しいPrintWriterを作成します。PrintWriter(Writer out, boolean autoFlush)新しいPrintWriterを作成します。PrintWriter(String fileName)行の自動フラッシュは行わずに、指定されたファイル名で新しいPrintWriterを作成します。PrintWriter(String fileName, String csn)行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。PrintWriter(String fileName, Charset charset)行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 PrintWriterappend(char c)指定された文字をこのライターに追加します。PrintWriterappend(CharSequence csq)指定された文字シーケンスをこのライターに追加します。PrintWriterappend(CharSequence csq, int start, int end)指定された文字シーケンスのサブシーケンスをこのライターに追加します。booleancheckError()ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。protected voidclearError()このストリームのエラー状態を解除します。voidclose()ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。voidflush()ストリームをフラッシュします。PrintWriterformat(String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。PrintWriterformat(Locale l, String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。voidprint(boolean b)boolean型の値を出力します。voidprint(char c)文字を出力します。voidprint(char[] s)文字の配列を出力します。voidprint(double d)倍精度の浮動小数点数を出力します。voidprint(float f)浮動小数点数を出力します。voidprint(int i)整数を出力します。voidprint(long l)long整数を出力します。voidprint(Object obj)オブジェクトを出力します。voidprint(String s)文字列を出力します。PrintWriterprintf(String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。PrintWriterprintf(Locale l, String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。voidprintln()行の区切り文字列を書き込むことで、現在の行を終了させます。voidprintln(boolean x)boolean値を出力し、行を終了させます。voidprintln(char x)文字を出力し、行を終了させます。voidprintln(char[] x)文字の配列を出力し、行を終了させます。voidprintln(double x)倍精度浮動小数点数を出力し、行を終了させます。voidprintln(float x)浮動小数点数を出力し、行を終了させます。voidprintln(int x)整数を出力し、行を終了させます。voidprintln(long x)long型の整数値を出力し、行を終了させます。voidprintln(Object x)Objectを出力し、行を終了させます。voidprintln(String x)文字列を出力し、行を終了させます。protected voidsetError()エラーが発生したことを示します。voidwrite(char[] buf)文字の配列を書き込みます。voidwrite(char[] buf, int off, int len)文字の配列の一部を書き込みます。voidwrite(int c)単一の文字を書き込みます。voidwrite(String s)文字列を書き込みます。voidwrite(String s, int off, int len)文字列の一部を書き込みます。クラス java.io.Writerで宣言されたメソッド
nullWriter
-
フィールド詳細
-
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メソッド、printfメソッド、またはformatメソッドは出力バッファをフラッシュする
-
PrintWriter
public PrintWriter(OutputStream out)行の自動フラッシュは行わずに、既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要となる中間のOutputStreamWriterを作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。- パラメータ:
out- 出力ストリーム- 関連項目:
OutputStreamWriter(java.io.OutputStream)
-
PrintWriter
public PrintWriter(OutputStream out, boolean autoFlush)既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要となる中間のOutputStreamWriterを作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。- パラメータ:
out- 出力ストリームautoFlush- boolean値。trueの場合、printlnメソッド、printfメソッド、またはformatメソッドは出力バッファをフラッシュする- 関連項目:
OutputStreamWriter(java.io.OutputStream)
-
PrintWriter
public PrintWriter(OutputStream out, boolean autoFlush, Charset charset)既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要な中間OutputStreamWriterを作成します。これは、指定されたcharsetを使用して文字をバイトに変換します。- パラメータ:
out- 出力ストリームautoFlush- boolean値。trueの場合、printlnメソッド、printfメソッド、またはformatメソッドは出力バッファをフラッシュするcharset- A charset- 導入されたバージョン:
- 10
-
PrintWriter
public PrintWriter(String fileName) throws FileNotFoundException行の自動フラッシュは行わずに、指定されたファイル名で新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。- パラメータ:
fileName- このライターの宛先として使用されるファイルの名前。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。- 例外:
FileNotFoundException- 指定された文字列が既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合SecurityException- セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合- 導入されたバージョン:
- 1.5
-
PrintWriter
public PrintWriter(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
fileName- このライターの宛先として使用されるファイルの名前。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。csn- サポートされているcharsetの名前- 例外:
FileNotFoundException- 指定された文字列が既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合SecurityException- セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合UnsupportedEncodingException- 指定された文字セットがサポートされていない場合- 導入されたバージョン:
- 1.5
-
PrintWriter
public PrintWriter(String fileName, Charset charset) throws IOException行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
fileName- このライターの宛先として使用されるファイルの名前。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。charset- A charset- 例外:
IOException- ファイルのオープンまたは作成中にI/Oエラーが発生した場合SecurityException- セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合- 導入されたバージョン:
- 10
-
PrintWriter
public PrintWriter(File file) throws FileNotFoundException行の自動フラッシュは行わずに、指定されたファイルで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。- パラメータ:
file- このライターの宛先として使用されるファイル。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。- 例外:
FileNotFoundException- 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合SecurityException- セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合- 導入されたバージョン:
- 1.5
-
PrintWriter
public PrintWriter(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
file- このライターの宛先として使用されるファイル。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。csn- サポートされているcharsetの名前- 例外:
FileNotFoundException- 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合SecurityException- セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合UnsupportedEncodingException- 指定された文字セットがサポートされていない場合- 導入されたバージョン:
- 1.5
-
PrintWriter
public PrintWriter(File file, Charset charset) throws IOException行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
file- このライターの宛先として使用されるファイル。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。charset- A charset- 例外:
IOException- ファイルのオープンまたは作成中にI/Oエラーが発生した場合SecurityException- セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合- 導入されたバージョン:
- 10
-
-
メソッドの詳細
-
flush
public void flush()ストリームをフラッシュします。- 定義:
flush、インタフェース:Flushable- 定義:
flush、クラス:Writer- 関連項目:
checkError()
-
close
public void close()ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 すでに閉じられているストリームを閉じても、何の影響もありません。- 定義:
close、インタフェース:AutoCloseable- 定義:
close、インタフェース:Closeable- 定義:
close、クラス:Writer- 関連項目:
checkError()
-
checkError
public boolean checkError()ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。- 戻り値:
- ベースとなる出力ストリームで、またはフォーマット変換中に、プリント・ストリームがエラーを検出した場合は
true。
-
setError
protected void setError()エラーが発生したことを示します。このメソッドを使用すると、
clearError()が呼び出されるまで、checkError()の以降の呼出しではtrueが返されます。 -
clearError
protected void clearError()このストリームのエラー状態を解除します。このメソッドを使用すると、別の書込み操作が失敗して、
setError()が呼び出されるまで、checkError()の以降の呼出しではfalseが返されます。- 導入されたバージョン:
- 1.6
-
write
public void write(int c)単一の文字を書き込みます。 -
write
public void write(char[] buf, int off, int len)文字の配列の一部を書き込みます。- 定義:
write、クラス:Writer- パラメータ:
buf- 文字の配列off- 文字の書込み開始オフセットlen- 書き込む文字数- 例外:
IndexOutOfBoundsException-offおよびlenパラメータの値によって、下にあるWriterの対応するメソッドがIndexOutOfBoundsExceptionをスローする場合
-
write
public void write(char[] buf)文字の配列を書き込みます。 入出力例外を抑制しなければならないので、このメソッドをWriterクラスから継承することはできません。 -
write
public void write(String s, int off, int len)文字列の一部を書き込みます。- オーバーライド:
write、クラス:Writer- パラメータ:
s- 文字列off- 文字の書込み開始オフセットlen- 書き込む文字数- 例外:
IndexOutOfBoundsException-offおよびlenパラメータの値によって、下にあるWriterの対応するメソッドがIndexOutOfBoundsExceptionをスローする場合
-
write
public void write(String s)文字列を書き込みます。 入出力例外を抑制しなければならないので、このメソッドをWriterクラスから継承することはできません。 -
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()行の区切り文字列を書き込むことで、現在の行を終了させます。 行セパレータはSystem.lineSeparator()であり、必ずしも単一の改行文字('\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)文字列を出力し、行を終了させます。 このメソッドは、print(String)とprintln()を呼び出すように動作します。- パラメータ:
x- 出力されるString値
-
println
public void println(Object x)Objectを出力し、行を終了させます。 このメソッドは最初にString.valueOf(x)を呼び出して印刷オブジェクトの文字列値を取得し、print(String)とprintln()を呼び出すように動作します。- パラメータ:
x- 出力されるObject値。
-
printf
public PrintWriter printf(String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。このメソッドを
out.printf(format, args)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。out.format(format, args)- パラメータ:
format- 「書式文字列の構文」で説明した書式文字列。args- 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、「Java Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数がnullの場合、動作は変換に応じて異なる。- 戻り値:
- このライター
- 例外:
IllegalFormatException- 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の「詳細」セクションを参照。NullPointerException-formatがnullである場合- 導入されたバージョン:
- 1.5
-
printf
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- 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、「Java Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数がnullの場合、動作は変換に応じて異なる。- 戻り値:
- このライター
- 例外:
IllegalFormatException- 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の「詳細」セクションを参照。NullPointerException-formatがnullである場合- 導入されたバージョン:
- 1.5
-
format
public PrintWriter format(String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。このオブジェクトに対して別の書式設定メソッドが先に呼び出されていたかどうかにかかわらず、
Locale.getDefault()により返されるロケールが常に使用されます。- パラメータ:
format- 「書式文字列の構文」で説明した書式文字列。args- 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、「Java Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数がnullの場合、動作は変換に応じて異なる。- 戻り値:
- このライター
- 例外:
IllegalFormatException- 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、Formatterクラス仕様の「詳細」セクションを参照。NullPointerException-formatがnullである場合- 導入されたバージョン:
- 1.5
-
format
public PrintWriter format(Locale l, String format, Object... args)指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。- パラメータ:
l- 書式設定時に適用するlocale。lがnullの場合、ローカリゼーションは適用されない。format- 「書式文字列の構文」で説明した書式文字列。args- 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、「Java Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数がnullの場合、動作は変換に応じて異なる。- 戻り値:
- このライター
- 例外:
IllegalFormatException- 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の「詳細」セクションを参照。NullPointerException-formatがnullである場合- 導入されたバージョン:
- 1.5
-
append
public PrintWriter append(CharSequence csq)指定された文字シーケンスをこのライターに追加します。このメソッドを
out.append(csq)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。out.write(csq.toString())charシーケンス
csqに対するtoStringの指定に応じて、シーケンス全体が追加されないこともあります。 たとえば、charバッファのtoStringメソッドを呼び出した場合、そのバッファの位置とリミットによって決まる内容を持つサブシーケンスが返されます。- 定義:
append、インタフェース:Appendable- オーバーライド:
append、クラス:Writer- パラメータ:
csq- 追加するcharシーケンス。csqがnullの場合は、このライターに「null」という4文字が追加される。- 戻り値:
- このライター
- 導入されたバージョン:
- 1.5
-
append
public PrintWriter append(CharSequence csq, int start, int end)指定された文字シーケンスのサブシーケンスをこのライターに追加します。csqがnullでないときに、このメソッドをout.append(csq, start, end)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。out.write(csq.subSequence(start, end).toString())- 定義:
append、インタフェース:Appendable- オーバーライド:
append、クラス:Writer- パラメータ:
csq- サブシーケンスの追加元のcharシーケンス。csqがnullの場合は、csqに「null」という4 charが含まれているかのようにcharが追加されるstart- サブシーケンスの最初のcharのインデックスend- サブシーケンスの最後のcharのあとに続くcharのインデックス- 戻り値:
- このライター
- 例外:
IndexOutOfBoundsException-startまたはendが負の値の場合、startがendよりも大きい場合、あるいはendがcsq.length()よりも大きい場合- 導入されたバージョン:
- 1.5
-
append
public PrintWriter append(char c)指定された文字をこのライターに追加します。このメソッドを
out.append(c)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。out.write(c)- 定義:
append、インタフェース:Appendable- オーバーライド:
append、クラス:Writer- パラメータ:
c- 追加する16ビット文字- 戻り値:
- このライター
- 導入されたバージョン:
- 1.5
-