(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
pspell_new_personal — 載入新的個人詞彙表字典
$filename,$language,$spelling = "",$jargon = "",$encoding = "",$mode = 0pspell_new_personal() 會開啟一個新的字典,並使用個人單字清單。如有需要,可以使用 pspell_save_wordlist() 修改並儲存單字清單。但是,取代配對不會被儲存。若要儲存取代配對,您應該使用 pspell_config_create() 建立一個設定,使用 pspell_config_personal() 設定個人單字清單檔案,使用 pspell_config_repl() 設定取代配對的檔案,然後使用 pspell_new_config() 開啟一個新的字典。
更多資訊和範例,請參考線上 pspell 手冊網站:» http://aspell.net/。
filename新增至個人清單的單字將儲存於此檔案中。它應該是一個以 '/' 開頭的絕對路徑檔名,否則它會相對於 $HOME,在大部分系統中是 "/root",這可能不是您想要的。
language語言代碼,由兩個字母的 ISO 639 語言代碼組成,並在破折號或底線後可選擇加上兩個字母的 ISO 3166 國家/地區代碼。
spelling針對擁有多種拼法的語言(例如英語)所要求的拼法。已知的值為 'american'、'british' 和 'canadian'。
jargon用於區分具有相同語言和拼寫參數的兩個不同單字清單的額外資訊。
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 - 將連在一起的單字視為合法的複合詞。也就是說,"thecat" 將會是一個合法的複合詞,即使這兩個單字之間應該有一個空格。更改此設定只會影響 pspell_check() 返回的結果;pspell_suggest() 仍然會返回建議。
PSPELL_FAST、PSPELL_NORMAL 和 PSPELL_BAD_SPELLERS 互斥,因此您應該只選擇其中一個。
成功時返回 PSpell\Dictionary 實例,失敗時返回 false。
| 版本 | 說明 |
|---|---|
| 8.1.0 | 現在返回 PSpell\Dictionary 實例;先前返回的是 資源。 |
範例 #1 pspell_new_personal()
<?php
$pspell = pspell_new_personal ("/var/dictionaries/custom.pws",
"en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER);
?>