- すべての実装されたインタフェース:
Closeable
,Flushable
,Appendable
,AutoCloseable
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を作成します。 -
メソッドのサマリー
修飾子と型メソッド説明append
(char c) 指定された文字をこのライターに追加します。append
(CharSequence csq) 指定された文字シーケンスをこのライターに追加します。append
(CharSequence csq, int start, int end) 指定された文字シーケンスのサブシーケンスをこのライターに追加します。boolean
ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。protected void
このストリームのエラー状態を解除します。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
オブジェクトを出力します。void
文字列を出力します。指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。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
Objectを出力し、行を終了させます。void
文字列を出力し、行を終了させます。protected void
setError()
エラーが発生したことを示します。void
write
(char[] buf) 文字の配列を書き込みます。void
write
(char[] buf, int off, int len) 文字の配列の一部を書き込みます。void
write
(int c) 単一の文字を書き込みます。void
文字列を書き込みます。void
文字列の一部を書き込みます。クラス 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
- 出力ストリーム- 関連項目:
-
PrintWriter
public PrintWriter(OutputStream out, boolean autoFlush) 既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要となる中間のOutputStreamWriterを作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。- パラメータ:
out
- 出力ストリームautoFlush
- boolean値。trueの場合、println
メソッド、printf
メソッド、またはformat
メソッドは出力バッファをフラッシュする- 関連項目:
-
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()ストリームをフラッシュします。 -
close
public void close()ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 すでに閉じられているストリームを閉じても、何の影響もありません。 -
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
値- 関連項目:
-
print
public void print(long l) long整数を出力します。String.valueOf(long)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
l
- 出力されるlong
値- 関連項目:
-
print
public void print(float f) 浮動小数点数を出力します。String.valueOf(float)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
f
- 出力されるfloat
値- 関連項目:
-
print
public void print(double d) 倍精度の浮動小数点数を出力します。String.valueOf(double)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
d
- 出力される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
値- 関連項目:
-
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
-