クラスPrintStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.PrintStream

すべての実装されたインタフェース:

Closeable, Flushable, Appendable, AutoCloseable

直系の既知のサブクラス:

LogStream

public class PrintStream extends FilterOutputStream implements Appendable, Closeable

PrintStreamは、ほかの出力ストリー� に機能、具体的には、さまざまなデータ値の表現を簡易的に出力する機能を追� します。 同様に、ほかの2つの機能も提供されています。 PrintStreamはほかの出力ストリー� とは違って、IOExceptionをスローすることはありません。例外的な状況では、単に内部フラグが設定される� けです。このフラグの状態は、checkErrorメソッドで調べることができます。 オプションで、自動的にフラッシュするようにPrintStreamを作成できます。これは、バイト配列の書込み、printlnメソッドの1つの起動、または改行文字またはバイト('\n')の書込み後に、基礎となる出力ストリー� のflushメソッドが自動的に起動されることを意味します。

PrintStreamによって出力されるすべての文字は、指定されたエンコーディングまたは文字セットを使用してバイトに変換されるか、指定されていない� �合はデフォルトの文字セットに変換されます。 PrintWriterクラスは、バイトではなく文字を記述する必要がある� �合に使用する必要があります。

このクラスは、不正な形式およびマッピング不可能な文字シーケンスを、文字セットのデフォルト置換文字列で常に置き換えます。 エンコード処理をより強力に制御する必要がある� �合は、CharsetEncoderクラスを使用してく� さい。

導入されたバージョン:

1.0

関連� �目:

• Charset.defaultCharset()

フィールドのサマリー

クラス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)	行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリー� を作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
PrintStream	append(char c)	この出力ストリー� に指定された文字を追� します。
PrintStream	append(CharSequence csq)	この出力ストリー� に指定された文字シーケンスを追� します。
PrintStream	append(CharSequence csq, int start, int end)	指定された文字シーケンスのサブシーケンスをこの出力ストリー� に追� します。
Charset	charset()	このPrintStreamインスタンスで使用される文字セットを返します。
boolean	checkError()	ストリー� が閉じられていない� �合は、そのストリー� をフラッシュし、エラー状態をチェックします。
protected void	clearError()	このストリー� のエラー状態を解除します。
void	close()	ストリー� を閉じます。
void	flush()	ストリー� をフラッシュします。
PrintStream	format(String format, Object... args)	指定された書式文字列および引数を使用して、書式付き文字列をこの出力ストリー� の宛先に書き込みます。
PrintStream	format(Locale l, 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)	文字列を出力します。
PrintStream	printf(String format, Object... args)	書式付き文字列を、指定された書式文字列と引数を使用し、この出力ストリー� に書き込む便利な方法です。
PrintStream	printf(Locale l, String format, Object... args)	書式付き文字列を、指定された書式文字列と引数を使用し、この出力ストリー� に書き込む便利な方法です。
void	println()	行の区切り文字列を書き込むことで、現在の行を終了させます。
void	println(boolean x)	ブール値を出力してから行を終了します。
void	println(char x)	文字を出力し、行を終了させます。
void	println(char[] x)	文字の配列を出力し、行を終了させます。
void	println(double x)	doubleを出力してから行を終了します。
void	println(float x)	float値を出力し、行を終了します。
void	println(int x)	整数を出力し、行を終了させます。
void	println(long x)	long値を出力してから、行を終了します。
void	println(Object x)	Objectを出力し、行を終了させます。
void	println(String x)	文字列を出力し、行を終了させます。
protected void	setError()	ストリー� のエラー状態をtrueに設定します。
void	write(byte[] buf)	指定されたバイト配列のすべてのバイトをこのストリー� に書き込みます。
void	write(byte[] buf, int off, int len)	指定されたバイト配列のオフセット位置offから始まるlenバイトをこのストリー� に書き込みます。
void	write(int b)	指定されたバイトを、このストリー� に書き込みます。
void	writeBytes(byte[] buf)	指定されたバイト配列のすべてのバイトをこのストリー� に書き込みます。

クラスjava.io.OutputStreamで宣言されたメソッド

nullOutputStream

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

PrintStream

public PrintStream(OutputStream out)

指定されたOutputStreamで新規の印刷ストリー� が自動行フラッシュなしで作成されます。 ストリー� に書き込まれる文字は、デフォルトの文字セットを使用してバイトに変換されます。outはPrintStreamで、印刷ストリー� で使用される文字セットです。

パラメータ:

out - 値とオブジェクトが出力される出力ストリー�

関連� �目:

• PrintWriter(java.io.OutputStream)
• Charset.defaultCharset()

PrintStream

public PrintStream(OutputStream out, boolean autoFlush)

指定されたOutputStreamおよび行フラッシュを使用して、新規の印刷ストリー� を作成します。 ストリー� に書き込まれる文字は、デフォルトの文字セットを使用してバイトに変換されます。outはPrintStreamで、印刷ストリー� で使用される文字セットです。

パラメータ:

out - 値とオブジェクトが出力される出力ストリー�

autoFlush - バイト配列が書き込まれるときに出力バッファがフラッシュされるか、printlnメソッドの1つが呼び出されるか、または改行文字かバイト('\n')が書き込まれるか。

関連� �目:

• PrintWriter(java.io.OutputStream, boolean)
• Charset.defaultCharset()

PrintStream

public PrintStream(OutputStream out, boolean autoFlush, String encoding) throws UnsupportedEncodingException

指定されたOutputStream、行フラッシュおよび文字エンコーディングを使用して、新規の出力ストリー� を作成します。

パラメータ:

out - 値とオブジェクトが出力される出力ストリー�

autoFlush - バイト配列が書き込まれるときに出力バッファがフラッシュされるか、printlnメソッドの1つが呼び出されるか、または改行文字かバイト('\n')が書き込まれるか。

encoding - サポートされる文字エンコーディングの名前

スロー:

UnsupportedEncodingException - 指定されたエンコーディングがサポートされていない� �合

導入されたバージョン:

1.4

PrintStream

public PrintStream(OutputStream out, boolean autoFlush, Charset charset)

指定されたOutputStream、行フラッシュおよび文字セットを含む新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。

パラメータ:

out - 値とオブジェクトが出力される出力ストリー�

autoFlush - バイト配列が書き込まれるときに出力バッファがフラッシュされるか、printlnメソッドの1つが呼び出されるか、または改行文字かバイト('\n')が書き込まれるか。

charset - A charset

導入されたバージョン:

10

PrintStream

public PrintStream(String fileName) throws FileNotFoundException

行の自動フラッシュは行わずに、指定の名前で新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。

パラメータ:

fileName - この出力ストリー� の宛先として使用するファイルの名前。 ファイルが存在する� �合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに� �納される。

スロー:

FileNotFoundException - 指定されたファイル・オブジェクトが既存のファイルを示さない� �合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない� �合、またはファイルのオープンまたは作成中にその他のエラーが発生した� �合

導入されたバージョン:

1.5

関連� �目:

• Charset.defaultCharset()

PrintStream

public PrintStream(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException

行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。

パラメータ:

fileName - この出力ストリー� の宛先として使用するファイルの名前。 ファイルが存在する� �合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに� �納される。

csn - サポートされているcharsetの名前

スロー:

FileNotFoundException - 指定されたファイル・オブジェクトが既存のファイルを示さない� �合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない� �合、またはファイルのオープンまたは作成中にその他のエラーが発生した� �合

UnsupportedEncodingException - 指定された文字セットがサポートされていない� �合

導入されたバージョン:

1.5

PrintStream

public PrintStream(String fileName, Charset charset) throws IOException

行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。

パラメータ:

fileName - この出力ストリー� の宛先として使用するファイルの名前。 ファイルが存在する� �合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに� �納される。

charset - A charset

スロー:

IOException - ファイルのオープンまたは作成中にI/Oエラーが発生した� �合

導入されたバージョン:

10

PrintStream

public PrintStream(File file) throws FileNotFoundException

行の自動フラッシュは行わずに、指定のファイルで新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。

パラメータ:

file - この出力ストリー� の宛先として使用するファイル。 ファイルが存在する� �合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに� �納される。

スロー:

FileNotFoundException - 指定されたファイル・オブジェクトが既存のファイルを示さない� �合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない� �合、またはファイルのオープンまたは作成中にその他のエラーが発生した� �合

導入されたバージョン:

1.5

関連� �目:

• Charset.defaultCharset()

PrintStream

public PrintStream(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException

行の自動フラッシュは行わずに、指定のファイルと文字セットで新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。

パラメータ:

file - この出力ストリー� の宛先として使用するファイル。 ファイルが存在する� �合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに� �納される。

csn - サポートされているcharsetの名前

スロー:

FileNotFoundException - 指定されたファイル・オブジェクトが既存のファイルを示さない� �合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない� �合、またはファイルのオープンまたは作成中にその他のエラーが発生した� �合

UnsupportedEncodingException - 指定された文字セットがサポートされていない� �合

導入されたバージョン:

1.5

PrintStream

public PrintStream(File file, Charset charset) throws IOException

行の自動フラッシュは行わずに、指定のファイルと文字セットで新しい出力ストリー� を作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。

パラメータ:

file - この出力ストリー� の宛先として使用するファイル。 ファイルが存在する� �合、サイズ0に切り詰められる。ファイルがなければ新しいファイルが作成される。 出力はファイルに書き込まれ、バッファに� �納される。

charset - A charset

スロー:

IOException - ファイルのオープンまたは作成中にI/Oエラーが発生した� �合

導入されたバージョン:

10

メソッドの詳細

flush

public void flush()

ストリー� をフラッシュします。 バッファされた出力バイトをベースとなる出力ストリー� に書き込み、このストリー� をフラッシュします。

定義:

flush、インタフェースFlushable

オーバーライド:

flush、クラスFilterOutputStream

関連� �目:

• OutputStream.flush()

close

public void close()

ストリー� を閉じます。 ストリー� をフラッシュし、ベースとなる出力ストリー� を閉じます。

定義:

close、インタフェースAutoCloseable

定義:

close、インタフェースCloseable

オーバーライド:

close、クラスFilterOutputStream

関連� �目:

• OutputStream.close()

checkError

public boolean checkError()

ストリー� が閉じられていない� �合は、そのストリー� をフラッシュし、エラー状態をチェックします。

戻り値:

このストリー� がIOExceptionを検出した� �合、またはsetErrorメソッドが呼び出された� �合のみtrue

setError

protected void setError()

ストリー� のエラー状態をtrueに設定します。

このメソッドにより、clearError()が呼び出されるまで、checkError()の後続の呼出しでtrueが返されます。

導入されたバージョン:

1.1

clearError

protected void clearError()

このストリー� のエラー状態を解除します。

このメソッドにより、別の書込み操作が失敗してsetError()が呼び出されるまで、checkError()の後続の呼出しでfalseが戻されます。

導入されたバージョン:

1.6

write

public void write(int b)

指定されたバイトを、このストリー� に書き込みます。 バイトが改行で、自動フラッシュが有効になっている� �合は、基礎となる出力ストリー� でflushメソッドが起動されます。

バイトは指定どおりに書き込まれ、デフォルトの文字セットに従って変換される文字を記述するには、print(char)またはprintln(char)メソッドを使用します。

オーバーライド:

write、クラスFilterOutputStream

パラメータ:

b - 書き込まれるバイト

関連� �目:

• print(char)
• println(char)

write

public 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より大きい� �合

関連� �目:

• FilterOutputStream.write(int)

write

public 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 - 入出力エラーが発生した� �合。

関連� �目:

• writeBytes(byte[])
• write(byte[],int,int)

writeBytes

public void writeBytes(byte[] buf)

指定されたバイト配列のすべてのバイトをこのストリー� に書き込みます。 自動フラッシュが有効な� �合は、flushメソッドが呼び出されます。

バイトは指定どおりに書き込まれることに注意してく� さい。デフォルトの文字セットに従って変換される文字を記述するには、print(char[])またはprintln(char[])メソッドを使用します。

実装要件:

このメソッドはthis.write(buf, 0, buf.length)と同等です。

パラメータ:

buf - バイト配列

導入されたバージョン:

14

print

public void print(boolean b)

boolean型の値を出力します。 String.valueOf(boolean)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。

パラメータ:

b - 出力されるboolean値

関連� �目:

• Charset.defaultCharset()

print

public void print(char c)

文字を出力します。 文字は、コンストラクタに指定された文字エンコーディングに従って1つ以上のバイトに変換されるか、何も指定されていない� �合はデフォルトの文字セットに変換されます。 これらのバイトは、write(int)メソッドによって正確に書き込まれます。

パラメータ:

c - 出力されるchar値

関連� �目:

• Charset.defaultCharset()

print

public void print(int i)

整数を出力します。 String.valueOf(int)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。

パラメータ:

i - 出力されるint値

関連� �目:

• Integer.toString(int)
• Charset.defaultCharset()

print

public void print(long l)

long整数を出力します。 String.valueOf(long)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。

パラメータ:

l - 出力されるlong値

関連� �目:

• Long.toString(long)
• Charset.defaultCharset()

print

public void print(float f)

浮動小数点数を出力します。 String.valueOf(float)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。

パラメータ:

f - 出力されるfloat値

関連� �目:

• Float.toString(float)
• Charset.defaultCharset()

print

public void print(double d)

倍精度の浮動小数点数を出力します。 String.valueOf(double)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。

パラメータ:

d - 出力されるdouble値

関連� �目:

• Double.toString(double)
• Charset.defaultCharset()

print

public void print(char[] s)

文字の配列を出力します。 文字は、コンストラクタに指定された文字エンコーディングに従ってバイトに変換されるか、何も指定されていない� �合はデフォルトの文字セットに変換されます。 これらのバイトは、write(int)メソッドによって正確に書き込まれます。

パラメータ:

s - 出力されるcharの配列

スロー:

NullPointerException - sがnullである� �合

関連� �目:

• Charset.defaultCharset()

print

public void print(String s)

文字列を出力します。 引数がnullの� �合は、文字列"null"が出力されます。 それ以外の� �合、文字列文字はコンストラクタに指定された文字エンコーディングに従ってバイトに変換され、指定されていない� �合はデフォルトの文字セットに変換されます。 これらのバイトは、write(int)メソッドによって正確に書き込まれます。

パラメータ:

s - 出力されるString値

関連� �目:

• Charset.defaultCharset()

print

public void print(Object obj)

オブジェクトを出力します。 String.valueOf(Object)メソッドによって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの厳密な方法で書き込まれます。

パラメータ:

obj - 出力されるObject値

関連� �目:

• Object.toString()
• Charset.defaultCharset()

println

public void println()

行の区切り文字列を書き込むことで、現在の行を終了させます。 行の区切り文字列は、システ� ・プロパティline.separatorで定義され、必ずしも単一の改行文字('\n')であるとは限りません。

println

public void println(boolean x)

ブール値を出力してから行を終了します。 このメソッドは、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)

float値を出力し、行を終了します。 このメソッドは、print(float)とprintln()を呼び出すように動作します。

パラメータ:

x - 出力されるfloat値。

println

public void println(double x)

doubleを出力してから行を終了します。 このメソッドは、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を出力し、行を終了させます。 このメソッドは、firstString.valueOf(x)をコールして、出力されたオブジェクトの文字列値を取得してから、print(String)、println()の� �に起動するかのように動作します。

パラメータ:

x - 出力されるObject値。

printf

public 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

printf

public 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

format

public PrintStream format(String format, Object... args)

指定された書式文字列および引数を使用して、書式付き文字列をこの出力ストリー� の宛先に書き込みます。

常に使用されるロケールは、FORMATカテゴリを指定してLocale.getDefault(Locale.Category)によって返されるもので、このオブジェクトに対する他の書式設定メソッドの以前の呼出しとは関係ありません。

パラメータ:

format - 「書式文字列の構文」で説明した書式文字列

args - 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い� �合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の� �合があります。 引数の最大数は、「Java Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数がnullの� �合、動作は変換に応じて異なる。

戻り値:

この出力ストリー�

スロー:

IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む� �合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の「詳細」セクションを参照。

NullPointerException - formatがnullの� �合

導入されたバージョン:

1.5

format

public 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

append

public PrintStream append(CharSequence csq)

この出力ストリー� に指定された文字シーケンスを追� します。

csqがnullでない� �合、out.append(csq)という形式のこのメソッドの起動は、呼出しとまったく同じように動作

    out.print(csq.toString())

文字シーケンスcsqのtoStringの指定によっては、シーケンス全体が追� されない� �合があります。 たとえば、文字バッファのtoStringメソッドを呼び出すと、内容がバッファの位置と制限によって異なる部分列が返されます。

定義:

append、インタフェースAppendable

パラメータ:

csq - 追� するcharシーケンス。 csqがnullの� �合、この出力ストリー� に4文字の"null"が追� されます。

戻り値:

この出力ストリー�

導入されたバージョン:

1.5

append

public 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

append

public PrintStream append(char c)

この出力ストリー� に指定された文字を追� します。

out.append(c)形式のこのメソッドの起動は、起動とまったく同じように動作

    out.print(c)

定義:

append、インタフェースAppendable

パラメータ:

c - 追� する16ビット文字

戻り値:

この出力ストリー�

導入されたバージョン:

1.5

charset

public Charset charset()

このPrintStreamインスタンスで使用される文字セットを返します。

戻り値:

このPrintStreamインスタンスで使用される文字セット

導入されたバージョン:

18