Edit Report a Bug

    pspell_new_personal

    (PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

    pspell_new_personal — Load a new dictionary with personal wordlist

    Description

    pspell_new_personal(
        string $filename,
        string $language,
        string $spelling = "",
        string $jargon = "",
        string $encoding = "",
        int $mode = 0
    ): PSpell\Dictionary|false

    pspell_new_personal() opens up a new dictionary with a personal wordlist. The wordlist can be modified and saved with pspell_save_wordlist(), if desired. However, the replacement pairs are not saved. In order to save replacement pairs, you should create a config using pspell_config_create(), set the personal wordlist file with pspell_config_personal(), set the file for replacement pairs with pspell_config_repl(), and open a new dictionary with pspell_new_config().

    For more information and examples, check out inline manual pspell website:» http://aspell.net/.

    Parameters

    filename

    The file where words added to the personal list will be stored. It should be an absolute filename beginning with '/' because otherwise it will be relative to $HOME, which is "/root" for most systems, and is probably not what you want.

    language

    The language code which consists of the two letter ISO 639 language code and an optional two letter ISO 3166 country code after a dash or underscore.

    spelling

    The requested spelling for languages with more than one spelling such as English. Known values are 'american', 'british', and 'canadian'.

    jargon

    Extra information to distinguish two different words lists that have the same language and spelling parameters.

    encoding

    The encoding that words are expected to be in. Valid values are utf-8, iso8859-*, koi8-r, viscii, cp1252, machine unsigned 16, machine unsigned 32.

    mode

    The mode in which spellchecker will work. There are several modes available:

    • PSPELL_FAST - Fast mode (least number of suggestions)
    • PSPELL_NORMAL - Normal mode (more suggestions)
    • PSPELL_BAD_SPELLERS - Slow mode (a lot of suggestions)
    • PSPELL_RUN_TOGETHER - Consider run-together words as legal compounds. That is, "thecat" will be a legal compound, although there should be a space between the two words. Changing this setting only affects the results returned by pspell_check(); pspell_suggest() will still return suggestions.
    Mode is a bitmask constructed from different constants listed above. However, PSPELL_FAST, PSPELL_NORMAL and PSPELL_BAD_SPELLERS are mutually exclusive, so you should select only one of them.

    Return Values

    Returns an PSpell\Dictionary instance on success, or false on failure.

    Changelog

    Version Description
    8.1.0 Returns an PSpell\Dictionary instance now; previously, a resource was returned.

    Examples

    Example #1 pspell_new_personal()

    <?php
    $pspell     = pspell_new_personal ("/var/dictionaries/custom.pws",
    "en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER);
    ?>

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top