- すべての実装されたインタフェース:
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()
ストリームのエラー状態をtrue
に設定します。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
- ブール。trueの場合、println
、printf
またはformat
メソッドは出力バッファをフラッシュ
-
PrintWriter
public PrintWriter(OutputStream out) 行の自動フラッシュは行わずに、既存のOutputStreamから新しいPrintWriterを作成します。 このコンビニエンス・コンストラクタは、デフォルトの文字セットを使用して文字をバイトに変換する必要な中間OutputStreamWriterを作成します。out
はPrintStream
で、印刷ストリームで使用される文字セットです。- パラメータ:
out
- 出力ストリーム- 関連項目:
-
PrintWriter
public PrintWriter(OutputStream out, boolean autoFlush) 既存のOutputStreamから新しいPrintWriterを作成します。 このコンビニエンス・コンストラクタは、デフォルトの文字セットを使用して文字をバイトに変換する必要な中間OutputStreamWriterを作成します。out
はPrintStream
で、印刷ストリームで使用される文字セットです。- パラメータ:
out
- 出力ストリームautoFlush
- ブール。trueの場合、println
、printf
またはformat
メソッドは出力バッファをフラッシュ- 関連項目:
-
PrintWriter
public PrintWriter(OutputStream out, boolean autoFlush, Charset charset) 既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要な中間OutputStreamWriterを作成します。これは、指定されたcharsetを使用して文字をバイトに変換します。- パラメータ:
out
- 出力ストリームautoFlush
- ブール。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()ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。- 戻り値:
- このストリームが
IOException
を検出した場合、またはsetError
メソッドが呼び出された場合のみtrue
-
setError
protected void setError()ストリームのエラー状態をtrue
に設定します。このメソッドにより、
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())
文字シーケンス
csq
のtoString
の指定によっては、シーケンス全体が追加されない場合があります。 たとえば、文字バッファのtoString
メソッドを呼び出すと、内容がバッファの位置と制限によって異なる部分列が返されます。- 定義:
append
、インタフェースAppendable
- オーバーライド:
append
、クラスWriter
- パラメータ:
csq
- 追加するcharシーケンス。csq
がnull
の場合、このライターに4文字の"null"
が追加されます。- 戻り値:
- このライター
- 導入されたバージョン:
- 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
に4文字の"null"
が含まれているかのように、文字が追加されます。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
-