モジュール java.base

パッケージ java.io

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

SecurityException - セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合

導入されたバージョン:

1.5

関連項目:

• Charset.defaultCharset()

PrintStream

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

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

パラメータ:

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

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

例外:

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

SecurityException - セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合

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

導入されたバージョン:

1.5

PrintStream

public PrintStream(String fileName, Charset charset) throws IOException

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

パラメータ:

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

charset - A charset

例外:

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

SecurityException - セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合

導入されたバージョン:

10

PrintStream

public PrintStream(File file) throws FileNotFoundException

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

パラメータ:

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

例外:

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

SecurityException - セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合

導入されたバージョン:

1.5

関連項目:

• Charset.defaultCharset()

PrintStream

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

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

パラメータ:

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

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

例外:

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

SecurityException - セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合

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

導入されたバージョン:

1.5

PrintStream

public PrintStream(File file, Charset charset) throws IOException

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

パラメータ:

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

charset - A charset

例外:

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

SecurityException - セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合

導入されたバージョン:

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

導入されたバージョン:

14

関連項目:

• 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)

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

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