pspell_new_personal

Beschreibung

int pspell_new_personal ( string persönliche_wortliste, string Sprache [, string Schreibweise [, string Jargon [, string Codierung [, int Modus]]]])

pspell_new_personal() öffnet ein neues Wörterbuch mit einer persönlichen Wortliste und gibt die Kennung des Wörterbuch-Links für die Verwendung in anderen pspell-Funktionen zurück. Die Wortliste kann bei Bedarf mit pspell_save_wordlist() geändert und gespeichert werden. Die Ersetzen-Paare werden jedoch nicht gespeichert. Um diese zu speichern, müssen Sie mittels pspell_config_create() eine Konfiguration erzeugen, die persönliche Wortliste mit pspell_config_personal() setzen, die Datei für die Ersetzen-Paare mit pspell_config_repl() setzen und mit pspell_new_config() ein neues Wörterbuch öffnen.

persönliche_wortliste bestimmt die Datei, in der Wörter, die zur persönlichen Wortliste hinzu gefügt wurden, gespeichert werden. Dieser Parameter sollte als absoluter Dateiname mit '/' beginnend angegeben werden, weil er andernfalls relativ zu $HOME wäre, was auf den meisten Systemen '/root' ist und es vermutlich nicht das ist, was sie wollen.

Sprache ist der Sprachencode, der aus dem zweibuchstabigen ISO 639-Sprachencode und, nach einem Binde- oder Unterstrich, einem optionalen zweibuchstabigen ISO 3166-Ländercode besteht.

Schreibweise ist die angeforderte Schreibweise für Sprachen mit mehr als einer Schreibweise, wie zum Beispiel Englisch. Bekannte Werte sind 'american', 'british' und 'canadian'.

Jargon enthält zusätzliche Informationen, um zwischen zwei Wortlisten mit der selben Sprache und den selben Parametern für die Schreibweise zu unterscheiden.

Codierung ist die Codierung, in der die Wörter voraussichtlich sind. Gültige Werte sind 'utf-8', 'iso8859-*', 'koi8-r', 'viscii', 'cp1252', 'machine unsigned 16' und 'machine unsigned 32'. Dieser Parameter ist weit gehend ungetestet, weshalb Sie bei dessen Verwendung vorsichtig sein sollten.

Modus ist der Modus, in dem die Rechtschreibprüfung arbeitet. Es stehen mehrere Modi zur Verfügung:

• PSPELL_FAST - Schneller Modus (geringste Anzahl Vorschläge)

• PSPELL_NORMAL - Normaler Modus (mehr Vorschläge)

• PSPELL_BAD_SPELLERS - Langsamer Modus (viele Vorschläge)

• PSPELL_RUN_TOGETHER - Betrachtet zusammengesetzte Wörter als erlaubte Verbindungen. Das heißt, dieSpinne wäre dann eine erlaubte Verbindung, obwohl ein Leerzeichen zwischen den beiden Wörtern sein müsste. Eine Änderung dieser Einstellung wirkt sich nur auf das Ergebnis aus, das von pspell_check() zurückgegeben wird; pspell_suggest() liefert weiterhin Änderungsvorschläge.

Modus ist eine Bitmask, die sich aus verschiedenden der oben aufgelisteten Konstanten zusammensetzt. PSPELL_FAST, PSPELL_NORMAL und PSPELL_BAD_SPELLERS schließen sich allerdings gegenseitig aus, weshalb Sie nur eine davon auswählen sollten.

Schauen Sie sich für weitere Informationen und Beispiele das pspell-Handbuch (auf englisch) auf der Website http://aspell.net/ an.

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