BinaryTreeSearch (LHA Library for Java)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

LHA Library for Java

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

jp.gr.java_conf.dangan.util.lha
クラス BinaryTreeSearch

java.lang.Object
  jp.gr.java_conf.dangan.util.lha.BinaryTreeSearch

すべての実装インタフェース:: LzssSearchMethod

public class BinaryTreeSearch
extends Object
implements LzssSearchMethod

二分木を使用した LzssSearchMethod の実装。

 データ圧縮ハンドブック[改定第二版]
        M.ネルソン/J.-L.ゲィリー 著
                萩原剛志・山口英 訳
                  ISBN4-8101-8605-9
                             5728円(税抜き,当方の購入当時の価格)

を参考にした。
二分木では、最長一致を見つけることはできるが、最も近い一致を見つけられるとは限らないため、 LZSSで一致位置が近い場所に偏る事を利用するような -lh5- のような圧縮法では、圧縮率はいくらか低下する。

 -- revision history --
 $Log: BinaryTreeSearch.java,v $
 Revision 1.0  2002/08/06 00:00:00  dangan
 add to version control
 [change]
     LzssSearchMethod のインタフェイス変更にあわせてインタフェイス変更
 [maintenance]
     ソース整備
     タブ廃止
     ライセンス文の修正

バージョン:: $Revision: 1.0 $
作成者:: $Author: dangan $

コンストラクタの概要
`BinaryTreeSearch(int DictionarySize, int MaxMatch, int Threshold, byte[] TextBuffer)` 二分木を使用した LzssSearchMethod を構築する。

メソッドの概要
`void`	`put(int position)` position から始まるデータパタンを二分木に登録する。
`int`	`putRequires()` put() または searchAndPut() を使用してデータパタンを二分木に登録する際に必要とするデータ量を得る。
`int`	`search(int position, int lastPutPos)` 二分木に登録されたデータパタンを検索し position から始まるデータパタンと最長の一致を持つものを得る。
`int`	`searchAndPut(int position)` 二分木に登録されたデータパタンから position から始まるデータパタンと最長の一致を持つものを検索し、同時に position から始まるデータパタンを二分木に登録する。
`void`	`slide()` TextBuffer内のpositionまでのデータを前方へ移動する際、それに応じて二分木を構成するデータも TextBuffer内のデータと矛盾しないように前方へ移動する処理を行う。

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

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

コンストラクタの詳細

BinaryTreeSearch

public BinaryTreeSearch(int DictionarySize,
                        int MaxMatch,
                        int Threshold,
                        byte[] TextBuffer)

二分木を使用した LzssSearchMethod を構築する。
パラメータ:: DictionarySize - 辞書サイズ; MaxMatch - 最長一致長; Threshold - 圧縮、非圧縮の閾値; TextBuffer - LZSS圧縮を施すためのバッファ

メソッドの詳細

put

public void put(int position)

position から始まるデータパタンを二分木に登録する。

定義:: インタフェース LzssSearchMethod 内の put

パラメータ:: position - TextBuffer内のデータパタンの開始位置

searchAndPut

public int searchAndPut(int position)

二分木に登録されたデータパタンから position から始まるデータパタンと最長の一致を持つものを検索し、同時に position から始まるデータパタンを二分木に登録する。

定義:: インタフェース LzssSearchMethod 内の searchAndPut

パラメータ:: position - TextBuffer内のデータパタンの開始位置。
戻り値:: 一致が見つかった場合は LzssOutputStream.createSearchReturn によって生成された一致位置と一致長の情報を持つ値、一致が見つからなかった場合は LzssOutputStream.NOMATCH。
関連項目:: LzssOutputStream.createSearchReturn(int,int), LzssOutputStream.NOMATCH

search

public int search(int position,
                  int lastPutPos)

二分木に登録されたデータパタンを検索し position から始まるデータパタンと最長の一致を持つものを得る。
TextBuffer.length < position + MaxMatch となるような position では、二分木を完全に走査できないため最長一致を得られるとは限らない。

定義:: インタフェース LzssSearchMethod 内の search

パラメータ:: position - TextBuffer内のデータパタンの開始位置。; lastPutPos - 最後に登録したデータパタンの開始位置。
戻り値:: 一致が見つかった場合は LzssOutputStream.createSearchReturn によって生成された一致位置と一致長の情報を持つ値、一致が見つからなかった場合は LzssOutputStream.NOMATCH。
関連項目:: LzssOutputStream.createSearchReturn(int,int), LzssOutputStream.NOMATCH