pspell_new_personal

説明

int pspell_new_personal ( string personal, string language, string [spelling], string [jargon], string [encoding], int [mode])

pspell_new_personal() は、個人の単語リストと共 に新規辞書をオープンし、辞書リンクIDを返します。このIDは他の pspell関数で使用されます。単語リストは修正可能で、必要に応じて pspell_save_wordlist()で保存することも可能です。 しかし、置換の組は保存されません。置換の組を保存するには、 pspell_config_create()を用いて設定を作成し、 pspell_config_personal()で個人の単語リストを設 定し、pspell_config_repl()で置換のファイルを設 定し、pspell_new_config()で新規の辞書をオープ ンします。

パラメータpersonalは、個人リストに追加された単語が保存される場所 を指定します。この場所には、'/'で始まる絶対パスのファイル名を指定 する必要があります。これは、そうでない場合、$HOMEに相対パスになり、 これは、多くのシステムでは、"/root"であるため、恐らく望ましい結果 とはならないためです。

パラメータlanguageは、2文字のISO 639言語コードおよびオプションで ダッシュまたはアンダースコアの後に2文字のISO 3166 国コードを加え たものからなる言語コードです。

パラメータspellingは、英語のように 複数の表記を有する言語について表記を指定します。既知の値は、 ``american'',``britsh'', ``canadian''があります。

パラメータjargonには、同じlanguageおよびspellingを有する異なる2種 類の単語に関する追加情報を有しています。

encodingパラメータは、その単語が属していると予想されるエンコーディ ングです。有効な値は、'utf-8', 'iso8859-*', 'koi8-r', 'viscii', 'cp1252', 'machine unsigned 16', 'machine unsigned 32'です。この パラメータはあまりテストされていないため、使用に際しては注意を要 します。

パラメータmodeは、スペルチェッカの動作モー ドです。以下に示す複数のモードを使用可能です。

• PSPELL_FAST - 高速モード (修正候補の数は最小)

• PSPELL_NORMAL - 通常モード (修正候補はより多い)

• PSPELL_BAD_SPELLERS - 低速モード (修正候補は多い)

• PSPELL_RUN_TOGETHER - 継った単語を複合語(legal compound)とし て考慮します。この場合、"thecat" には二つの単語の間に空白はあ りませんが複合語となります。この設定の変更は、 pspell_check()から返される結果にのみ影響し ます。設定変更後もpspell_suggest()は修正候 補を返します。

mode は、上記の異なる定数を用いたビットマスクです。 しかし、PSPELL_FAST、PSPELL_NORMAL、PSPELL_BAD_SPELLERS は 相反するため、この中の一つを選択する必要があります。

詳細な情報および例については、pspellのWebサイト :http://aspell.net/ にあるインラインマニュアルを参照下さい。

例 1pspell_new_personal() $pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws", "en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER));