15章：入出力

トップ->Java Applet入門

Java入門内検索

このページの先頭に戻る

トップページに戻る

このページの先頭に戻る
 トップページに戻る

トップ-> Java入門：15章入出力-> PrintStream

前ページへ　:　トップへ　:　次ページへ

29. PrintStream

　　PrintStreamクラスは他のOutputStreamクラスにつなげて、プリミティブ型やクラスオブジェクトをフォーマットして文字列に変換し、この文字列をデフォルトのコーディング方法によってバイトに変換され、これが出力されます。

　　簡単に言えば今まで用いてきた「System.out.println」のような使い方ができるようになります。 printメソッドは改行無し、printlnは改行ありのメソッドですが、改行コードはプラットフォームによって異なるため、printメソッドの最後に"\r\n"を追加した物と同じではありません。改行を行う場合には println メソッドを使うことが推奨されています。

　　このクラスでは自動行フラッシュ機能を使うこともできます。この機能を使うかはコンストラクタの引数で指定します。この機能はprintlnメソッドを呼び出した際に自動的にフラッシュを行う機能です。頻繁に書き込みを行う場合には不要にして、flushメソッドを明示的に呼び出した方が効率的です。

　　このクラスはIOExceptionを投げません。内部でエラーフラグを保持するだけです。

import java.io.PrintStream

コンストラクタ

PrintStream(OutputStream outStream)

outStreamを出力先としてPrintStreamを作成します。

PrintStream(OutputStream outStream, boolean autoFlush)

outStreamを出力先としてPrintStreamを作成します。
autoFlushがtrueの場合は自動行フラッシュ機能を有効にします。

メソッド

boolean checkError()



フラッシュし、ストリームの状態を調べます。
ストリームにエラーがあればtrueを返します。

void print(boolean a)
print(byte a)
print(char a)
print(int a)
print(long a)
print(double a)
print(float a)
print(char[] a) throws NullPointerException
print(Object a)
print(String a)



引数を出力します。
引数がObjectの場合は、そのクラスのtoStringメソッドが呼ばれます。
文字配列がnullの場合にNullPointerExceptionが投げられます。

void println(boolean a)
println(byte a)
println(char a)
println(int a)
println(long a)
println(double a)
println(float a)
println(char[] a) throws NullPointerException
println(Object a)
println(String a)



引数を出力し、改行します。
自動行フラッシュ機能が有効の場合は出力後フラッシュします。
引数がObjectの場合は、そのクラスのtoStringメソッドが呼ばれます。
文字配列がnullの場合にNullPointerExceptionが投げられます。

void write(int b)



bの下位1バイト書き込みます。

void write(byte[] buf)



データを書き込みます。
bufがnullの場合はNullPointerExceptionが返されます。

void write(byte[] buf, int off, int len)



bufのoffバイト目からlenバイトのデータを書き込みます。
off, lenが負数の場合、off+lenが配列bufの大きさを超える場合にはIndexOutOfBoundsExceptionが返されます。
bがnullの場合はNullPointerExceptionが返されます。

void close()



ストリームをクローズします。

void flush()



この出力ストリームをフラッシュし、バッファに入っている出力バイトをすべて強制的に書き込みます。

前ページへ　:　トップへ　:　次ページへ