bzlibのヘッダファイルはbzlib.hで,どんな関数があるかを一覧できる. bzlibは以下でインストールする.

apt-get install libbz2-dev

で,bzlibを使用する際の大まかな流れは,zlibと同様のパターンで,プログラム上は,ほぼ関数名が異なるだけと言ってよいような状況のようだ. そこで今回のサンプルは,前頁のzlibのサンプルを単にbzlib版に変更したものにした.

データをbz2形式圧縮してファイル出力するサンプルを以下に示す. 簡易APIを使用すると,通常のファイル出力やzlib使用時と同様,オープン,書き出し,クローズの三段階の手順となる.

ファイルのオープン

ファイルのオープンはfopenに似ている.

BZFILE *
BZ2_bzopen(
  const char *path,
  const char *mode
);

pathが出力ファイルパス,modeは(たぶん)fopenのモードで"rb"か"wb"である. BZ2_bzopenで返されるBZFILEオブジェクトが,今後の各bzlib関数に渡すハンドラとなる. エラー時は返り値がNULLとなる.

圧縮と書き出し

データの圧縮と書き出しは一つの関数呼び出しで行える.

BZ_EXTERN int
BZ2_bzwrite(
  BZFILE* b, 
  void*   buf, 
  int     len 
);

第一引数はBZ2_bzopenの返りを使用する. あとは書き出しデータ(圧縮前)が格納されたバッファとその長さである. 返り値は書き出されたデータの圧縮前の長さが返される.

クローズ

クローズはfcloseと同様,簡単. 第一引数はgzopenの返りを使用する.

BZ_EXTERN void
BZ2_bzclose(
  BZFILE* b
);

gzcloseと異なり,返り値はない.

zlibと同様,bzlibでも関数呼び出しでエラー番号が返された場合,そのエラー番号からエラーメッセージを取得できる.

BZ_EXTERN const char *
BZ2_bzerror(
  BZFILE *b, 
  int    *errnum
);

返り値がerrnumに対応するエラーメッセージである. 第一引数はBZ2_bzopenの返りであり,クローズされたものは使用できない. だから,BZ2_bzopenやBZ2_bzclose失敗時には使用できない. 第二引数についてはよくわからない.

bz2形式ファイルを解凍して読み出すサンプルを以下に示す. 簡易APIを使用すると,やはり通常のファイル出力と同様,オープン,読み込み,クローズの三段階の手順となる. サンプルのクローズは圧縮時と同様である. オープンは圧縮時とは別の方法としてファイルディスクリプタを指定する方法を使用している. もちろん圧縮時と同様の方法も使用できるし,ファイルディスクリプタを使用する方法を圧縮時に使用することもできる.

ファイルディスクリプタ指定のオープン

gzdopenと同様,BZ2_bzdopenはファイルディスクリプタ指定でオープンできる.

BZ_EXTERN BZFILE *
BZ2_bzdopen(
  int        fd,
  const char *mode
);

ファイルディスクリプタを引数にもつので,圧縮データの読み書き対象がファイルだけでなく,ネットワークストリームやパイプであってもbzlibが使用できる. 当然ファイルディスクリプタは標準関数を使用してオープンしておく必要がある. 後でBZ2_bzcloseした場合,ファイルディスクリプタもクローズされる. 返り値はBZ2_bzopenと同様.

解凍と読み込み

解凍と読み込みは,一つの関数呼び出しでできる.

BZ_EXTERN int
BZ2_bzread(
  BZFILE* b, 
  void* buf, 
  int len 
);

第一引数はBZ2_bzopenやBZ2_bzopenの返り値,bufは読み込み用バッファ,lenは読み込む解凍後のデータサイズ, 返り値は読み込んだデータの解凍後のバイト数である.

コンパイルする際は,リンカオプションを設定する.

LDFLAGS=-lbz2

では,圧縮,解凍と続けて実行してみる.

# 圧縮
$ ./mybz2write outfile.bz2 FIREPROJECT 1000
wrote 11000

# 出力サイズは11000文字に対して69バイトなので,圧縮されているようだ
$ ls -l outfile.bz2 
-rw-r--r-- 1 matsu matsu 69 2007-04-30 12:58 outfile.bz2

# 解凍. 正しく11000文字に解凍されている.
$ ./mybz2read outfile.bz2 
read 11000

# ツールで出力を解凍,表示
$ bzcat outfile.bz2 
FIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPROJECTFIREPR...省略...
$ bzcat outfile.bz2 | wc -c
11000