jp.gr.java_conf.dangan.io
クラス BitInputStream

java.lang.Object
  java.io.InputStream
      jp.gr.java_conf.dangan.io.BitInputStream

public class BitInputStream

extends InputStream

ビット入力のためのユーティリティクラス。

 -- revision history --
 $Log: BitInputStream.java,v $
 Revision 1.5  2002/12/07 00:00:00  dangan
 [maintenance]
     ソース整備

 Revision 1.4  2002/11/15 00:00:00  dangan
 [improvement]
     prefetchBits() が  32bit の読み込みを保証するように修正
 [change]
     メソッド名の変更
     prefetchBit     -> peekBit
     prefetchBoolean -> peekBoolean
     prefetchBits    -> peekBits

 Revision 1.3  2002/11/02 00:00:00  dangan
 [bug fix]
     available() availableBits() で
     ブロックせずに読み込める量よりも大きい値を返していた。

 Revision 1.2  2002/09/05 00:00:00  dangan
 [change]
     EndOfStream に達した後の read( new byte[0] ) や 
     read( byte[] buf, int off, 0 ) の戻り値を
     InputStream と同じく 0 になるようにした

 Revision 1.1  2002/09/04 00:00:00  dangan
 [bug fix]
     skip( len ) と skipBits( len ) で len が 0 未満のとき
     正しく処理できていなかった。

 Revision 1.0  2002/09/03 00:00:00  dangan
 add to version control
 [bug fix]
     mark() で 接続された in に渡す readLimit の計算が甘かったため、
     要求された readLimit に達する前にマーク位置が破棄される事があった。
     EndOfStream に達した後の skip() および skip( 0 ) が -1 を返していた。
 [maintenance]
     タブ廃止
     ライセンス文の修正


 

バージョン:

$Revision: 1.5 $

作成者:

$Author: dangan $

コンストラクタの概要

BitInputStream(InputStream in)
入力ストリーム in からのデータをビット単位で 読み込めるようなストリームを構築する。

BitInputStream(InputStream in, int CacheSize)
入力ストリーム in からのデータをビット単位で 読み込めるようなストリームを構築する。

メソッドの概要

int	available() 接続された入力ストリームからブロックしないで 読み込むことのできるバイト数を得る。
int	availableBits() 接続された入力ストリームからブロックしないで 読み込むことのできるビット数を得る。
void	close() この入力ストリームを閉じ、 使用していたリソースを開放する。
void	mark(int readLimit) 接続された入力ストリームの現在位置にマークを設定し、 reset() メソッドでマークした時点の 読み込み位置に 戻れるようにする。
boolean	markSupported() 接続された入力ストリームが mark() と reset() を サポートするかを得る。
int	peekBit() 読み込み位置を変えずに 1ビットのデータを先読みする。
int	peekBits(int count) 読み込み位置を変えずに count ビットのデータを先読みする。
boolean	peekBoolean() 読み込み位置を変えずに 1ビットのデータを 真偽値として先読みする。
int	read() 接続されたストリームから 8ビットのデータを読み込む。
int	read(byte[] buffer) 接続された入力ストリームから バイト配列 buffer を 満たすようにデータを読み込む。
int	read(byte[] buffer, int index, int length) 接続された入力ストリームから バイト配列 buffer の index で指定された位置から length バイトのデータを 読み込む。
int	readBit() 接続された入力ストリームから 1ビットのデータを 読み込む。
int	readBits(int count) 接続された入力ストリームから count ビットのデータを 読み込む。
boolean	readBoolean() 接続された入力ストリームから 1ビットのデータを 真偽値として読み込む。
void	reset() 接続された入力ストリームの読み込み位置を最後に mark() メソッドが呼び出されたときの位置に設定する。
long	skip(long length) 接続された入力ストリームのデータを length バイト 読み飛ばす。
int	skipBits(int count) 接続されたストリームから count ビットのデータを 読み飛ばす。

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

BitInputStream

public BitInputStream(InputStream in)

入力ストリーム in からのデータをビット単位で 読み込めるようなストリームを構築する。

パラメータ:

in - 入力ストリーム

BitInputStream

public BitInputStream(InputStream in,
                      int CacheSize)

入力ストリーム in からのデータをビット単位で 読み込めるようなストリームを構築する。

パラメータ:

in - 入力ストリーム

CacheSize - バッファサイズ

メソッドの詳細

read

public int read()
         throws IOException

接続されたストリームから 8ビットのデータを読み込む。

戻り値:

読み出された 8ビットのデータ。
既に EndOfStream に達している場合は -1

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

BitDataBrokenException - EndOfStreamに達したため 要求されたビット数のデータの 読み込みに失敗した場合。

read

public int read(byte[] buffer)
         throws IOException

接続された入力ストリームから バイト配列 buffer を 満たすようにデータを読み込む。
データは必ずしも buffer を満たすとは限らないことに注意。

パラメータ:

buffer - 読み込まれたデータを格納するためのバイト配列

戻り値:

buffer に読み込んだデータ量をバイト数で返す。
既に EndOfStream に達していた場合は -1 を返す。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

BitDataBrokenException - EndOfStreamに達したため 要求されたビット数のデータの 読み込みに失敗した場合。

read

public int read(byte[] buffer,
                int index,
                int length)
         throws IOException

接続された入力ストリームから バイト配列 buffer の index で指定された位置から length バイトのデータを 読み込む。
このメソッドは lengthバイト読み込むか、 EndOfStream に到達するまでブロックする。
データは必ずしも length バイト読み込まれるとは限ら ないことに注意。

パラメータ:

buffer - 読み込まれたデータを格納するためのバイト配列

index - buffer内のデータ読み込み開始位置

length - bufferに読み込むデータ量

戻り値:

buffer に読み込んだデータ量をバイト数で返す。
既に EndOfStream に達していた場合は -1 を返す。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

BitDataBrokenException - EndOfStreamに達したため 要求されたビット数のデータの 読み込みに失敗した場合。

skip

public long skip(long length)
          throws IOException

接続された入力ストリームのデータを length バイト 読み飛ばす。
このメソッドは lengthバイト読み飛ばすか、 EndOfStream に到達するまでブロックする。
データは必ずしも length バイト読み飛ばされるとは限ら ないことに注意。

パラメータ:

length - 読み飛ばすバイト数。

戻り値:

実際に読み飛ばされたバイト数。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

mark

public void mark(int readLimit)

接続された入力ストリームの現在位置にマークを設定し、 reset() メソッドでマークした時点の 読み込み位置に 戻れるようにする。

パラメータ:

readLimit - マーク位置に戻れる限界のバイト数。 このバイト数を超えてデータを読み 込んだ場合 reset()できなくなる可 能性がある。

reset

public void reset()
           throws IOException

接続された入力ストリームの読み込み位置を最後に mark() メソッドが呼び出されたときの位置に設定する。

例外:

IOException -
(1) BitInputStream に mark がなされていない場合。
(2) 接続された入力ストリームが markSupported()で false を返す場合。
(3) 接続された入力ストリームで 入出力エラーが発生した場合。
の何れか。

markSupported

public boolean markSupported()

接続された入力ストリームが mark() と reset() を サポートするかを得る。

戻り値:

ストリームが mark() と reset() を サポートする場合は true。
サポートしない場合は false。

available

public int available()
              throws IOException

接続された入力ストリームからブロックしないで 読み込むことのできるバイト数を得る。

戻り値:

ブロックしないで読み出せるバイト数。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

close

public void close()
           throws IOException

この入力ストリームを閉じ、 使用していたリソースを開放する。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

readBit

public int readBit()
            throws IOException

接続された入力ストリームから 1ビットのデータを 読み込む。

戻り値:

読み込まれた1ビットのデータ。
既にEndOfStreamに達している場合は -1。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

readBoolean

public boolean readBoolean()
                    throws IOException

接続された入力ストリームから 1ビットのデータを 真偽値として読み込む。

戻り値:

読み込まれた1ビットのデータが 1であれば true、0であれば false を返す。

例外:

EOFException - 既にEndOfStreamに達していた場合

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

readBits

public int readBits(int count)
             throws IOException

接続された入力ストリームから count ビットのデータを 読み込む。 戻り値が int値である事からも判るように 読み込むことのできる 最大有効ビット数は 32ビットで あるが、count は32以上の値を設定してもチェックを 受けないため それ以上の値を設定した場合は ビット データが読み捨てられる。
たとえば readBits( 33 ) としたときは まず1ビットの データを読み捨て、その後の 32ビットのデータを返す。
また count に 0以下の数字を設定して呼び出した場合、 データを読み込む動作を伴わないため 戻り値は 常に0、 EndOfStream に達していても EOFException を 投げない点に注意すること。

パラメータ:

count - 読み込むデータのビット数

戻り値:

読み込まれたビットデータ。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

EOFException - 既にEndOfStreamに達していた場合

BitDataBrokenException - 読み込み途中で EndOfStreamに達したため 要求されたビット数のデータの読み込み に失敗した場合。

skipBits

public int skipBits(int count)
             throws IOException

接続されたストリームから count ビットのデータを 読み飛ばす。

パラメータ:

count - 読み飛ばしてほしいビット数

戻り値:

実際に読み飛びしたビット数

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

peekBit

public int peekBit()
            throws IOException

読み込み位置を変えずに 1ビットのデータを先読みする。

戻り値:

読み込まれた1ビットのデータ。
既にEndOfStreamに達している場合は -1。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

peekBoolean

public boolean peekBoolean()
                    throws IOException

読み込み位置を変えずに 1ビットのデータを 真偽値として先読みする。

戻り値:

読み込まれた1ビットのデータが 1であれば true、0であれば false を返す。

例外:

EOFException - 既にEndOfStreamに達していた場合

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

peekBits

public int peekBits(int count)
             throws IOException

読み込み位置を変えずに count ビットのデータを先読みする。
戻り値が int型であることからもわかるように 最大有効ビット数は 32ビットである。
EndOfStream 付近を除いて、先読み出来ることが保障されるのは 32ビットである。(ビットバッファの大きさが 32ビットであるため)
もし 32ビット以上の先読み機能が必須となる場合は その都度 mark()、readBits()、reset() を繰り返すか、 このクラスを使用することを諦めること。

パラメータ:

count - 読み込むビット数

戻り値:

先読みした count ビットのビットデータ

例外:

EOFException - 既にEndOfStreamに達していた場合

IOException - 接続された入力ストリームで 入出力エラーが発生した場合

NotEnoughBitsException - count が先読み可能な範囲外の場合

availableBits

public int availableBits()
                  throws IOException

接続された入力ストリームからブロックしないで 読み込むことのできるビット数を得る。

戻り値:

ブロックしないで読み出せるビット数。

例外:

IOException - 接続された入力ストリームで 入出力エラーが発生した場合