java.io
クラス PrintStream

java.lang.Object
  |
  +--java.io.OutputStream
        |
        +--java.io.PrintStream

public class PrintStream
extends OutputStream

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

PrintStream が出力したすべての文字は、プラットフォームのデフォルトの文字エンコーディングを使ってバイトに変換されます。

導入されたバージョン:
JDK1.0

コンストラクタの概要
PrintStream(OutputStream out)
          新しい PrintStream を作成します。
 
メソッドの概要
 boolean checkError()
          ストリームをフラッシュし、そのエラー状況を確認します。
 void close()
          ストリームを閉じます。
 void flush()
          ストリームをフラッシュします。
 void print(boolean b)
          boolean 値を出力します。
 void print(char c)
          文字を出力します。
 void print(char[] s)
          文字の配列を出力します。
 void print(int i)
          整数を出力します。
 void print(long l)
          long 整数を出力します。
 void print(Object obj)
          オブジェクトを出力します。
 void print(String s)
          文字列を出力します。
 void println()
          行区切り文字列を書き込むことによって、現在の行を終了します。
 void println(boolean x)
          boolean 値を出力して、行を終了します。
 void println(char x)
          文字を出力して、行を終了します。
 void println(char[] x)
          文字の配列を出力して、行を終了します。
 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, int off, int len)
          オフセット off から始まる指定のバイト配列から、このストリームに len バイトを書き込みます。
 void write(int b)
          指定されたバイトをこのストリームに書き込みます。
 
クラス java.io.OutputStream から継承したメソッド
write
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

PrintStream

public PrintStream(OutputStream out)
新しい PrintStream を作成します。このストリームは、自動的にフラッシュすることはありません。
パラメータ:
out - 値とオブジェクトが出力される出力ストリーム
メソッドの詳細

flush

public void flush()
ストリームをフラッシュします。バッファされた出力バイトを基本となる出力ストリームに書き込み、このストリームをフラッシュします。
オーバーライド:
クラス OutputStream 内の flush
関連項目:
OutputStream.flush()

close

public void close()
ストリームを閉じます。ストリームをフラッシュし、基本となる出力ストリームを閉じます。
オーバーライド:
クラス OutputStream 内の close
関連項目:
OutputStream.close()

checkError

public boolean checkError()
ストリームをフラッシュし、そのエラー状況を確認します。基本となる出力ストリームが IOException をスローした場合、および setError メソッドが呼び出された場合は、内部エラー状態は true に設定されます。
戻り値:
このストリームが IOException を検出した場合、または setError メソッドが呼び出された場合は true

setError

protected void setError()
ストリームのエラー状態を true に設定します。
導入されたバージョン:
JDK1.1

write

public void write(int b)
指定されたバイトをこのストリームに書き込みます。バイトが復帰改行で、自動フラッシュが有効な場合は、flush メソッドが呼び出されます。

バイトは、指定されたまま書き込まれることに注意してください。プラットフォームのデフォルトの文字エンコーディングに従って変換された文字を書き込むには、print(char) または println(char) メソッドを使用します。

オーバーライド:
クラス OutputStream 内の write
パラメータ:
b - 書き込まれるバイト
関連項目:
print(char), println(char)

write

public void write(byte[] buf,
                  int off,
                  int len)
オフセット off から始まる指定のバイト配列から、このストリームに len バイトを書き込みます。自動フラッシュが有効な場合は、flush メソッドが呼び出されます。

バイトは、指定されたまま書き込まれます。プラットフォームのデフォルトの文字エンコーディングに従って変換された文字列を書き込むには、print(char) メッソドまたは println(char) メソッドを使用します。

オーバーライド:
クラス OutputStream 内の write
パラメータ:
buf - バイト配列
off - バイトの取り込み開始オフセット
len - 書き込まれるバイト数

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(char[] s)
文字の配列を出力します。いくつかの文字列がプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、このバイトが write(int) メソッドとまったく同じ方法で書き込まれます。
パラメータ:
s - 出力される char の配列
例外:
NullPointerException - snull の場合

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(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 を出力して、行を終了します。このメソッドは、print(Object) を呼び出してから println() を呼び出すのと同じように動作します。
パラメータ:
x - 出力される Object