Provided by: libcanna1g-dev_3.7p3-25_amd64 
名前
CannaLib intro - かな漢字変換ライブラリイントロ
説明
『かんな』では次の３階層のライブラリを提供します．
・ 高レベルライブラリ
アプリケーションプログラムからはかな漢字変換を全く意識しないで利用でき 候補一覧表示を含む候補選択の処
理などはかな漢字変換システム側で行われ， アプリケーション側へは確定された文字列だけが渡されます．TTYで
の入力に おいてかな漢字変換フロントエンドを使っている場合には端末での入力に おけるシステムコール
のread(cooked mode)やそれを利用したscanfなどが高レ ベルライブラリとみなすこともできます．しかし，高レ
ベルライブラリライブ ラリを端的に表すようなライブラリとしてはＸウィンドウにおける日本語アテ ナウィ
ジェットのテキストウィジェットがそれに当たるでしょう．
・ ユーザインタフェースライブラリ
１文字の入力，１キーの入力に対応して，未確定文字，確定文字，注目文節位 置，ステータス表示のための文字
列，候補一覧のための文字列などを返還する ライブラリです．辞書アクセスライブラリに見られるような，辞書
のメンテナ ンスや，学習の制御などに関する機能は，このレベルのライブラリでは提供し ません．日本語入力
ユーザインタフェースの大まかなラインは規定されること になりますが，表示部分に 若干の工夫をする余地は残
ります．TTYにおいてrawモードで キーを取得したいアプリケーションや，Ｘウィンドウにおいて，図形 と文字を
同じウィンドウ内で入力・表示したいアプリケーションはこのレベル のアプリケーションインタフェースを用い
ることをお薦めします．
・ 辞書アクセスライブラリ
辞書のアクセスや候補の選択を直接制御したい時に用います．このレベルのか な漢字変換ライブラリでは，かな
漢字変換システムの利用開始，読みから漢字 への変換，文節の切り分けの変更，次候補/前候補の取りだし，学習
の制御， 辞書のメンテナンスなどの処理に対する関数インタフェースを提供します．辞 書アクセスライブラリは
ユーザインタフェースライブラリや高レベルライブラ リを構築するために用いられています．一般のユーザはあ
まり用いない方が良 いでしょう．
『かんな』では４つのヘッダファイルと３つのライブラリが提供されます．そ れぞれの概要を以下に示します．
・ ヘッダファイル
X11/Xnw.h 日本語アテナウィジェットを用いる時に使用するヘッダファイルです．
X11/kanji.h Ｘで日本語の入出力を行う時に使用するヘッダファイルです．
canna/jrkanji.h TTYレベルの日本語の入出力を行う時に使用するヘッダファイルです．
canna/RK.h 辞書アクセスライブラリを使用する時に用いるヘッダファイルです．
・ ライブラリ
libXnw アテナウィジェットXawの日本語版です．アプリケーションプログラムはかな 漢字変換を全く
意識することはありません．
libXn Ｘで日本語を取り扱う時のライブラリ です．XLookupKanjiString，XDrawKanjiStringなどを
使用する時はこのライブ ラリをリンクしなければなりません．
libcanna 日本語入力のための中核となるライブラリです．
以下のように利用する関数によってライブラリのリンクと，ヘッダファイルの インクルードを行わなければなりませ
ん．
・ アテナウィジェット
ヘッダファイル X11/Xnw.h
ライブラリ libXnw,libXn,libcanna
・ XDrawKanjiString
ヘッダファイル canna/kanji.h
ライブラリ libXn
・ XLookupKanjiString, XKanjiControl
ヘッダファイル canna/kanji.h
ライブラリ libXn, libcanna
・ jrKanjiString, jrKanjiControl
ヘッダファイル canna/jrkanji.h
ライブラリ libcanna
・ 辞書アクセスライブラリ
ヘッダファイル canna/RK.h
ライブラリ libcanna
変換コンテクスト
『かんな』では同時に複数のかな漢字変換を行うことができます．このため， それぞれのかな漢字変換を管理する方
法として変換コンテクストを用いた制御 を行います．各コンテクストにはかな漢字変換を行うために必要な内部デー
タ が確保されます．
アプリケーションは変換コンテクストをコンテクスト番号により識別します． コンテクスト番号は，0以上の整数値
で表され，かな漢字変換関数の第１パラ メタとして使用されます．
辞書アクセスライブラリのRkInitialize(3)によりかな漢字変換が初期化され た直後には番号0の標準コンテクストだ
けが存在します．コンテクストをひと つだけ使用するアプリケーションは標準コンテクストを使用することができま
す．
連文節変換の概要
連文節変換は，与えられたひらがなを解析して文節と呼ばれる単位に分けます． 解析例を示します．
「かなをかんじにへんかんする」
かなを 仮名を かなを
かんじに 漢字に 幹事に 感じに かんじに
へんかんする 変換する 返還する へんかんする
辞書アクセスライブラリの連文節変換機能で提供される関数は，この解析結果 を修正するか，解析情報を取得するか
のいずれかに分類されます．これらの関 数では２次元的な候補アドレスを想定します．
解析されたN個の文節には，左から順番に文節番号0,1,・・・,N-1を与え，こ のうち現在注目している候補をカレン
ト候補と呼びます．
例えば，「かなを」は文節番号0，候補番号0の候補と指定できます．ライブラ リではその代わりにコンテクストにカ
レント文節，カレント候補を仮定しパラ メタを簡略化しています．
関連情報
uilib(3) - ユーザインタフェースライブラリ diclib(3) - 辞書アクセスライブラリ 4 April 1991 CANNALIB(3)