- すべての実装されたインタフェース:
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
クラスは、バイトではなく文字の書き込みが必要な状況で使用する必要があります。
このクラスは、不正な形式およびマップ不可能な文字列を、常に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)
行の自動フラッシュは行わずに、指定の名前と文字セットで新しい出力ストリームを作成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 PrintStream
append(char c)
この出力ストリームに指定された文字を追加します。PrintStream
append(CharSequence csq)
この出力ストリームに指定された文字シーケンスを追加します。PrintStream
append(CharSequence csq, int start, int end)
指定された文字シーケンスのサブシーケンスをこの出力ストリームに追加します。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)
boolean値を出力して、行を終了します。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)
Stringを出力して、行を終了します。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
-
コンストラクタの詳細
-
PrintStream
public PrintStream(OutputStream out)指定されたOutputStreamで新規の印刷ストリームが自動行フラッシュなしで作成されます。 ストリームに書き込まれる文字は、プラットフォームのデフォルトの文字エンコードを使用してバイトに変換されます。- パラメータ:
out
- 値とオブジェクトが出力される出力ストリーム- 関連項目:
PrintWriter(java.io.OutputStream)
-
PrintStream
public PrintStream(OutputStream out, boolean autoFlush)指定されたOutputStreamおよび行フラッシュを使用して、新規の印刷ストリームを作成します。 ストリームに書き込まれる文字は、プラットフォームのデフォルトの文字エンコードを使用してバイトに変換されます。- パラメータ:
out
- 値とオブジェクトが出力される出力ストリームautoFlush
- バイト配列が書き込まれるときに出力バッファがフラッシュされるか、println
メソッドの1つが呼び出されるか、または改行文字かバイト('\n'
)が書き込まれるか。- 関連項目:
PrintWriter(java.io.OutputStream, boolean)
-
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
-
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
-
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()ストリームをフラッシュし、そのエラー状況を確認します。 ベースとなる出力ストリームがInterruptedIOException
ではなくIOException
をスローした場合、およびsetError
メソッドが呼び出された場合に、内部エラー状態はtrue
に設定されます。 ベースとなる出力ストリームのオペレーションがInterruptedIOException
をスローすると、PrintStream
が次の操作またはそれに相当する操作によって例外を変換して割り込みに戻します。
または同等のもの。Thread.currentThread().interrupt();
- 戻り値:
- このストリームで
InterruptedIOException
以外の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
- 書き込むバイト数- 関連項目:
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
値
-
print
public void print(char c)文字を出力します。 この文字は、コンストラクタに指定された文字エンコーディングに従って1つ以上のバイトに変換されるか、指定されない場合はプラットフォームのデフォルトの文字エンコーディングに変換されます。 これらのバイトは、write(int)
メソッドによって正確に書き込まれます。- パラメータ:
c
- 出力されるchar
値
-
print
public void print(int i)整数を出力します。String.valueOf(int)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
i
- 出力されるint
値- 関連項目:
Integer.toString(int)
-
print
public void print(long l)long整数を出力します。String.valueOf(long)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
l
- 出力されるlong
値- 関連項目:
Long.toString(long)
-
print
public void print(float f)浮動小数点数を出力します。String.valueOf(float)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
f
- 出力されるfloat
値- 関連項目:
Float.toString(float)
-
print
public void print(double d)倍精度の浮動小数点数を出力します。String.valueOf(double)
によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)
メソッドとまったく同じ方法で記述されます。- パラメータ:
d
- 出力されるdouble
値- 関連項目:
Double.toString(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
値- 関連項目:
Object.toString()
-
println
public void println()行の区切り文字列を書き込むことで、現在の行を終了させます。 行の区切り文字列は、システム・プロパティline.separator
で定義され、必ずしも単一の改行文字('\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)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)Stringを出力して、行を終了します。 このメソッドは、print(String)
とprintln()
を呼び出すように動作します。- パラメータ:
x
- 出力されるString
値。
-
println
public void println(Object x)Objectを出力して、行を終了します。 このメソッドは最初にString.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)指定された書式文字列および引数を使用して、書式付き文字列をこの出力ストリームの宛先に書き込みます。常に使用されるロケールは、
Locale.getDefault(Locale.Category)
によって指定されたFORMAT
カテゴリで返されたロケールで、このオブジェクトの他の書式設定メソッドの以前の呼び出しに関係なく使用されます。- パラメータ:
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())
charシーケンス
csq
に対するtoString
の指定に応じて、シーケンス全体が追加されないこともあります。 たとえば、文字バッファのtoString
メソッドを呼び出した場合、返されるサブシーケンスの内容はそのバッファの位置とリミットによって決まります。- 定義:
append
、インタフェース:Appendable
- パラメータ:
csq
- 追加するcharシーケンス。csq
がnull
の場合は、この出力ストリームに「null
」という4文字が追加される。- 戻り値:
- この出力ストリーム
- 導入されたバージョン:
- 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
に「null」
という4 charが含まれているかのようにcharが追加される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
-