Ubuntu Manpage: CannaLib intro - かな漢字変換ライブラリイントロ

Provided by: libcanna1g-dev_3.7p3-14_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の候補と指定できます．ライブラ  リではその代わりに
       コンテクストにカレント文節，カレント候補を仮定しパラ メタを簡略化しています．

名前

説明

変換コンテクスト

連文節変換の概要

関連情報