- すべての実装されたインタフェース:
- Closeable,- Flushable,- Appendable,- AutoCloseable
- 直系の既知のサブクラス:
- LogStream
PrintStreamは、ほかの出力ストリームに機能、具体的には、さまざまなデータ値の表現を簡易的に出力する機能を追加します。 同様に、ほかの2つの機能も提供されています。 PrintStreamはほかの出力ストリームとは違って、IOExceptionをスローすることはありません。例外的な状況では、単に内部フラグが設定されるだけです。このフラグの状態は、checkErrorメソッドで調べることができます。 オプションで、自動的にフラッシュするようにPrintStreamを作成できます。これは、バイト配列の書込み、printlnメソッドの1つの起動、または改行文字またはバイト('\n')の書込み後に、基礎となる出力ストリームのflushメソッドが自動的に起動されることを意味します。 
  PrintStreamによって出力されるすべての文字は、指定されたエンコーディングまたは文字セットを使用してバイトに変換されるか、指定されていない場合はデフォルトの文字セットに変換されます。 PrintWriterクラスは、バイトではなく文字の書き込みが必要な状況で使用する必要があります。 
 
このクラスは、不正な形式およびマップ不可能な文字列を、常にcharsetのデフォルトの置換文字列で置き換えます。 エンコード処理をより強力に制御する必要がある場合は、CharsetEncoderクラスを使用してください。
- 導入されたバージョン:
- 1.0
- 関連項目:
- 
フィールドのサマリークラス java.io.FilterOutputStreamで宣言されたフィールドout
- 
コンストラクタのサマリーコンストラクタコンストラクタ説明PrintStream(File file) 行の自動フラッシュは行わずに、指定のファイルで新しい出力ストリームを作成します。PrintStream(File file, String csn) 行の自動フラッシュは行わずに、指定のファイルと文字セットで新しい出力ストリームを作成します。PrintStream(File file, Charset charset) 行の自動フラッシュは行わずに、指定のファイルと文字セットで新しい出力ストリームを作成します。PrintStream(OutputStream out) 指定されたOutputStreamで新規の印刷ストリームが自動行フラッシュなしで作成されます。PrintStream(OutputStream out, boolean autoFlush) 指定されたOutputStreamおよび行フラッシュを使用して、新規の印刷ストリームを作成します。PrintStream(OutputStream out, boolean autoFlush, String encoding) 指定されたOutputStream、行フラッシュおよび文字エンコーディングを使用して、新規の出力ストリームを作成します。PrintStream(OutputStream out, boolean autoFlush, Charset charset) 指定されたOutputStream、行フラッシュおよび文字セットを含む新しい出力ストリームを作成します。PrintStream(String fileName) 行の自動フラッシュは行わずに、指定の名前で新しい出力ストリームを作成します。PrintStream(String fileName, String csn) 行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリームを作成します。PrintStream(String fileName, Charset charset) 行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリームを作成します。
- 
メソッドのサマリー修飾子と型メソッド説明append(char c) この出力ストリームに指定された文字を追加します。append(CharSequence csq) この出力ストリームに指定された文字シーケンスを追加します。append(CharSequence csq, int start, int end) 指定された文字シーケンスのサブシーケンスをこの出力ストリームに追加します。charset()このPrintStreamインスタンスで使用される文字セットを返します。booleanストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。protected voidこのストリームのエラー状態を解除します。voidclose()ストリームを閉じます。voidflush()ストリームをフラッシュします。指定された書式文字列および引数を使用して、書式付き文字列をこの出力ストリームの宛先に書き込みます。指定された書式文字列および引数を使用して、書式付き文字列をこの出力ストリームの宛先に書き込みます。voidprint(boolean b) boolean型の値を出力します。voidprint(char c) 文字を出力します。voidprint(char[] s) 文字の配列を出力します。voidprint(double d) 倍精度の浮動小数点数を出力します。voidprint(float f) 浮動小数点数を出力します。voidprint(int i) 整数を出力します。voidprint(long l) long整数を出力します。voidオブジェクトを出力します。void文字列を出力します。書式付き文字列を、指定された書式文字列と引数を使用し、この出力ストリームに書き込む便利な方法です。書式付き文字列を、指定された書式文字列と引数を使用し、この出力ストリームに書き込む便利な方法です。voidprintln()行の区切り文字列を書き込むことで、現在の行を終了させます。voidprintln(boolean x) ブール値を出力してから行を終了します。voidprintln(char x) 文字を出力し、行を終了させます。voidprintln(char[] x) 文字の配列を出力し、行を終了させます。voidprintln(double x) doubleを出力してから行を終了します。voidprintln(float x) float値を出力し、行を終了します。voidprintln(int x) 整数を出力し、行を終了させます。voidprintln(long x) long値を出力してから、行を終了します。voidObjectを出力し、行を終了させます。void文字列を出力し、行を終了させます。protected voidsetError()ストリームのエラー状態をtrueに設定します。voidwrite(byte[] buf) 指定されたバイト配列のすべてのバイトをこのストリームに書き込みます。voidwrite(byte[] buf, int off, int len) 指定されたバイト配列のオフセット位置offから始まるlenバイトをこのストリームに書き込みます。voidwrite(int b) 指定されたバイトを、このストリームに書き込みます。voidwriteBytes(byte[] buf) 指定されたバイト配列のすべてのバイトをこのストリームに書き込みます。クラス java.io.OutputStreamで宣言されたメソッドnullOutputStream
- 
コンストラクタの詳細- 
PrintStreampublic PrintStream(OutputStream out) 指定されたOutputStreamで新規の印刷ストリームが自動行フラッシュなしで作成されます。 ストリームに書き込まれる文字は、デフォルトの文字セットを使用してバイトに変換されます。outはPrintStreamで、印刷ストリームで使用される文字セットです。- パラメータ:
- out- 値とオブジェクトが出力される出力ストリーム
- 関連項目:
 
- 
PrintStreampublic PrintStream(OutputStream out, boolean autoFlush) 指定されたOutputStreamおよび行フラッシュを使用して、新規の印刷ストリームを作成します。 ストリームに書き込まれる文字は、デフォルトの文字セットを使用してバイトに変換されます。outはPrintStreamで、印刷ストリームで使用される文字セットです。- パラメータ:
- out- 値とオブジェクトが出力される出力ストリーム
- autoFlush- バイト配列が書き込まれるときに出力バッファがフラッシュされるか、- printlnメソッドの1つが呼び出されるか、または改行文字かバイト(- '\n')が書き込まれるか。
- 関連項目:
 
- 
PrintStreampublic PrintStream(OutputStream out, boolean autoFlush, String encoding) throws UnsupportedEncodingException 指定されたOutputStream、行フラッシュおよび文字エンコーディングを使用して、新規の出力ストリームを作成します。- パラメータ:
- out- 値とオブジェクトが出力される出力ストリーム
- autoFlush- バイト配列が書き込まれるときに出力バッファがフラッシュされるか、- printlnメソッドの1つが呼び出されるか、または改行文字かバイト(- '\n')が書き込まれるか。
- encoding- サポートされる文字エンコーディングの名前
- 例外:
- UnsupportedEncodingException- 指定されたエンコーディングがサポートされていない場合
- 導入されたバージョン:
- 1.4
 
- 
PrintStreampublic PrintStream(OutputStream out, boolean autoFlush, Charset charset) 指定されたOutputStream、行フラッシュおよび文字セットを含む新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
- out- 値とオブジェクトが出力される出力ストリーム
- autoFlush- バイト配列が書き込まれるときに出力バッファがフラッシュされるか、- printlnメソッドの1つが呼び出されるか、または改行文字かバイト(- '\n')が書き込まれるか。
- charset- A charset
- 導入されたバージョン:
- 10
 
- 
PrintStreampublic PrintStream(String fileName) throws FileNotFoundException 行の自動フラッシュは行わずに、指定の名前で新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。- パラメータ:
- fileName- この出力ストリームの宛先として使用するファイルの名前。 ファイルが存在する場合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
- 例外:
- FileNotFoundException- 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
- SecurityException- セキュリティ・マネージャが存在し、- checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合
- 導入されたバージョン:
- 1.5
- 関連項目:
 
- 
PrintStreampublic PrintStream(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException 行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
- fileName- この出力ストリームの宛先として使用するファイルの名前。 ファイルが存在する場合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
- csn- サポートされているcharsetの名前
- 例外:
- FileNotFoundException- 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
- SecurityException- セキュリティ・マネージャが存在し、- checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合
- UnsupportedEncodingException- 指定された文字セットがサポートされていない場合
- 導入されたバージョン:
- 1.5
 
- 
PrintStreampublic PrintStream(String fileName, Charset charset) throws IOException 行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
- fileName- この出力ストリームの宛先として使用するファイルの名前。 ファイルが存在する場合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
- charset- A charset
- 例外:
- IOException- ファイルのオープンまたは作成中にI/Oエラーが発生した場合
- SecurityException- セキュリティ・マネージャが存在し、- checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合
- 導入されたバージョン:
- 10
 
- 
PrintStreampublic PrintStream(File file) throws FileNotFoundException 行の自動フラッシュは行わずに、指定のファイルで新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。- パラメータ:
- file- この出力ストリームの宛先として使用するファイル。 ファイルが存在する場合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
- 例外:
- FileNotFoundException- 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
- SecurityException- セキュリティ・マネージャが存在し、- checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合
- 導入されたバージョン:
- 1.5
- 関連項目:
 
- 
PrintStreampublic PrintStream(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException 行の自動フラッシュは行わずに、指定のファイルと文字セットで新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
- file- この出力ストリームの宛先として使用するファイル。 ファイルが存在する場合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
- csn- サポートされているcharsetの名前
- 例外:
- FileNotFoundException- 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
- SecurityException- セキュリティ・マネージャが存在し、- checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合
- UnsupportedEncodingException- 指定された文字セットがサポートされていない場合
- 導入されたバージョン:
- 1.5
 
- 
PrintStreampublic PrintStream(File file, Charset charset) throws IOException 行の自動フラッシュは行わずに、指定のファイルと文字セットで新しい出力ストリームを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。- パラメータ:
- file- この出力ストリームの宛先として使用するファイル。 ファイルが存在する場合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
- charset- A charset
- 例外:
- IOException- ファイルのオープンまたは作成中にI/Oエラーが発生した場合
- SecurityException- セキュリティ・マネージャが存在し、- checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合
- 導入されたバージョン:
- 10
 
 
- 
- 
メソッドの詳細- 
flushpublic void flush()ストリームをフラッシュします。 バッファされた出力バイトをベースとなる出力ストリームに書き込み、このストリームをフラッシュします。- 定義:
- flush、インタフェース- Flushable
- オーバーライド:
- flush、クラス- FilterOutputStream
- 関連項目:
 
- 
closepublic void close()ストリームを閉じます。 ストリームをフラッシュし、ベースとなる出力ストリームを閉じます。- 定義:
- close、インタフェース- AutoCloseable
- 定義:
- close、インタフェース- Closeable
- オーバーライド:
- close、クラス- FilterOutputStream
- 関連項目:
 
- 
checkErrorpublic boolean checkError()ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。- 戻り値:
- このストリームがIOExceptionを検出した場合、またはsetErrorメソッドが呼び出された場合のみtrue
 
- 
setErrorprotected void setError()ストリームのエラー状態をtrueに設定します。このメソッドにより、 clearError()が呼び出されるまで、checkError()の後続の呼出しでtrueが返されます。- 導入されたバージョン:
- 1.1
 
- 
clearErrorprotected void clearError()このストリームのエラー状態を解除します。このメソッドにより、別の書込み操作が失敗して setError()が呼び出されるまで、checkError()の後続の呼出しでfalseが戻されます。- 導入されたバージョン:
- 1.6
 
- 
writepublic void write(int b) 指定されたバイトを、このストリームに書き込みます。 バイトが改行で、自動フラッシュが有効になっている場合は、基礎となる出力ストリームでflushメソッドが起動されます。バイトは指定どおりに書き込まれ、デフォルトの文字セットに従って変換される文字を記述するには、 print(char)またはprintln(char)メソッドを使用します。- オーバーライド:
- write、クラス- FilterOutputStream
- パラメータ:
- b- 書き込まれるバイト
- 関連項目:
 
- 
writepublic void write(byte[] buf, int off, int len) 指定されたバイト配列のオフセット位置offから始まるlenバイトをこのストリームに書き込みます。 自動フラッシュが有効になっている場合、基礎となる出力ストリームでflushメソッドが起動されます。バイトは指定どおりに書き込まれることに注意してください。デフォルトの文字セットに従って変換される文字を記述するには、 print(char)またはprintln(char)メソッドを使用します。- オーバーライド:
- write、クラス- FilterOutputStream
- パラメータ:
- buf- バイト配列
- off- バイトの取込み開始オフセット
- len- 書き込むバイト数
- 例外:
- IndexOutOfBoundsException-- offが負の値の場合、- lenが負の値の場合、あるいは- lenが- b.length - offより大きい場合
- 関連項目:
 
- 
writepublic void write(byte[] buf) throws IOException 指定されたバイト配列のすべてのバイトをこのストリームに書き込みます。 自動フラッシュが有効になっている場合、基礎となる出力ストリームでflushメソッドが起動されます。バイトは指定どおりに書き込まれることに注意してください。デフォルトの文字セットに従って変換される文字を記述するには、 print(char[])またはprintln(char[])メソッドを使用します。- オーバーライド:
- write、クラス- FilterOutputStream
- APIのノート:
- IOExceptionのスローとして宣言されても、このメソッドは実際には何も実行しません。 かわりに、このクラスがオーバーライドする他のメソッドと同様に、- checkError()メソッドを介してテスト可能な内部フラグを設定します。- IOException用の- catchブロックを作成せずにバイト配列を書き込むには、- writeBytes(buf)または- write(buf, 0, buf.length)を使用します。
- 実装要件:
- このメソッドはthis.write(buf, 0, buf.length)と同等です。
- パラメータ:
- buf- バイト配列
- 例外:
- IOException- 入出力エラーが発生した場合。
- 導入されたバージョン:
- 14
- 関連項目:
 
- 
writeBytespublic void writeBytes(byte[] buf) 指定されたバイト配列のすべてのバイトをこのストリームに書き込みます。 自動フラッシュが有効な場合は、flushメソッドが呼び出されます。バイトは指定どおりに書き込まれることに注意してください。デフォルトの文字セットに従って変換される文字を記述するには、 print(char[])またはprintln(char[])メソッドを使用します。- 実装要件:
- このメソッドはthis.write(buf, 0, buf.length)と同等です。
- パラメータ:
- buf- バイト配列
- 導入されたバージョン:
- 14
 
- 
printpublic void print(boolean b) boolean型の値を出力します。String.valueOf(boolean)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。- パラメータ:
- b- 出力される- boolean値
- 関連項目:
 
- 
printpublic void print(char c) 文字を出力します。 文字は、コンストラクタに指定された文字エンコーディングに従って1つ以上のバイトに変換されるか、何も指定されていない場合はデフォルトの文字セットに変換されます。 これらのバイトは、write(int)メソッドによって正確に書き込まれます。- パラメータ:
- c- 出力される- char値
- 関連項目:
 
- 
printpublic void print(int i) 整数を出力します。String.valueOf(int)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。- パラメータ:
- i- 出力される- int値
- 関連項目:
 
- 
printpublic void print(long l) long整数を出力します。String.valueOf(long)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。- パラメータ:
- l- 出力される- long値
- 関連項目:
 
- 
printpublic void print(float f) 浮動小数点数を出力します。String.valueOf(float)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。- パラメータ:
- f- 出力される- float値
- 関連項目:
 
- 
printpublic void print(double d) 倍精度の浮動小数点数を出力します。String.valueOf(double)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。- パラメータ:
- d- 出力される- double値
- 関連項目:
 
- 
printpublic void print(char[] s) 文字の配列を出力します。 文字は、コンストラクタに指定された文字エンコーディングに従ってバイトに変換されるか、何も指定されていない場合はデフォルトの文字セットに変換されます。 これらのバイトは、write(int)メソッドによって正確に書き込まれます。- パラメータ:
- s- 出力されるcharの配列
- 例外:
- NullPointerException-- sが- nullである場合
- 関連項目:
 
- 
printpublic void print(String s) 文字列を出力します。 引数がnullの場合は、文字列"null"が出力されます。 それ以外の場合、文字列文字はコンストラクタに指定された文字エンコーディングに従ってバイトに変換され、指定されていない場合はデフォルトの文字セットに変換されます。 これらのバイトは、write(int)メソッドによって正確に書き込まれます。- パラメータ:
- s- 出力される- String値
- 関連項目:
 
- 
printpublic void print(Object obj) オブジェクトを出力します。String.valueOf(Object)メソッドによって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの厳密な方法で書き込まれます。- パラメータ:
- obj- 出力される- Object値
- 関連項目:
 
- 
printlnpublic void println()行の区切り文字列を書き込むことで、現在の行を終了させます。 行の区切り文字列は、システム・プロパティline.separatorで定義され、必ずしも単一の改行文字('\n')であるとは限りません。
- 
printlnpublic void println(boolean x) ブール値を出力してから行を終了します。 このメソッドは、print(boolean)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- boolean値
 
- 
printlnpublic void println(char x) 文字を出力し、行を終了させます。 このメソッドは、print(char)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- char値。
 
- 
printlnpublic void println(int x) 整数を出力し、行を終了させます。 このメソッドは、print(int)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- int値。
 
- 
printlnpublic void println(long x) long値を出力してから、行を終了します。 このメソッドは、print(long)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- long値。
 
- 
printlnpublic void println(float x) float値を出力し、行を終了します。 このメソッドは、print(float)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- float値。
 
- 
printlnpublic void println(double x) doubleを出力してから行を終了します。 このメソッドは、print(double)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- double値。
 
- 
printlnpublic void println(char[] x) 文字の配列を出力し、行を終了させます。 このメソッドは、print(char[])とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力されるcharの配列。
 
- 
printlnpublic void println(String x) 文字列を出力し、行を終了させます。 このメソッドは、print(String)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- String値。
 
- 
printlnpublic void println(Object x) Objectを出力し、行を終了させます。 このメソッドは最初にString.valueOf(x)を呼び出して印刷オブジェクトの文字列値を取得し、print(String)とprintln()を呼び出すように動作します。- パラメータ:
- x- 出力される- Object値。
 
- 
printfpublic PrintStream 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
 
- 
printfpublic PrintStream 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
 
- 
formatpublic PrintStream format(String format, Object... args) 指定された書式文字列および引数を使用して、書式付き文字列をこの出力ストリームの宛先に書き込みます。常に使用されるロケールは、 Locale.getDefault(Locale.Category)によって指定されたFORMATカテゴリで返されたロケールで、このオブジェクトの他の書式設定メソッドの以前の呼び出しに関係なく使用されます。- パラメータ:
- format- 「書式文字列の構文」で説明した書式文字列
- args- 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、「Java Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数が- nullの場合、動作は変換に応じて異なる。
- 戻り値:
- この出力ストリーム
- 例外:
- IllegalFormatException- 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の「詳細」セクションを参照。
- NullPointerException-- formatが- nullの場合
- 導入されたバージョン:
- 1.5
 
- 
formatpublic PrintStream 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
 
- 
appendpublic PrintStream append(CharSequence csq) この出力ストリームに指定された文字シーケンスを追加します。out.append(csq)形式のこのメソッドの起動は、起動とまったく同じように動作out.print(csq.toString())文字シーケンス csqのtoStringの指定によっては、シーケンス全体が追加されない場合があります。 たとえば、文字バッファのtoStringメソッドを起動すると、内容がバッファの位置と制限によって異なる部分列が返されます。- 定義:
- append、インタフェース- Appendable
- パラメータ:
- csq- 追加するcharシーケンス。- csqが- nullの場合、この出力ストリームに4文字の- "null"が追加されます。
- 戻り値:
- この出力ストリーム
- 導入されたバージョン:
- 1.5
 
- 
appendpublic PrintStream append(CharSequence csq, int start, int end) 指定された文字シーケンスのサブシーケンスをこの出力ストリームに追加します。csqがnullでない場合、out.append(csq, start, end)という形式のこのメソッドの呼出しは、起動とまったく同じように動作out.print(csq.subSequence(start, end).toString())- 定義:
- append、インタフェース- Appendable
- パラメータ:
- csq- サブシーケンスの追加元のcharシーケンス。- csqが- nullの場合、- csqに4文字の- "null"が含まれているかのように、文字が追加されます。
- start- サブシーケンスの最初のcharのインデックス
- end- サブシーケンスの最後のcharのあとに続くcharのインデックス
- 戻り値:
- この出力ストリーム
- 例外:
- IndexOutOfBoundsException-- startまたは- endが負の場合、- startが- endより大きいか、- endが- csq.length()より大きいです
- 導入されたバージョン:
- 1.5
 
- 
appendpublic PrintStream append(char c) この出力ストリームに指定された文字を追加します。out.append(c)形式のこのメソッドの起動は、起動とまったく同じように動作out.print(c)- 定義:
- append、インタフェース- Appendable
- パラメータ:
- c- 追加する16ビット文字
- 戻り値:
- この出力ストリーム
- 導入されたバージョン:
- 1.5
 
- 
charsetpublic Charset charset()このPrintStreamインスタンスで使用される文字セットを返します。- 戻り値:
- このPrintStreamインスタンスで使用される文字セット
- 導入されたバージョン:
- 18
 
 
-