array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pspell-new-personal.php', 1 => 'pspell_new_personal', 2 => 'Carrega um novo dicionário com lista de palavras pessoal', ), 'up' => array ( 0 => 'ref.pspell.php', 1 => 'Funções de Pspell', ), 'prev' => array ( 0 => 'function.pspell-new-config.php', 1 => 'pspell_new_config', ), 'next' => array ( 0 => 'function.pspell-save-wordlist.php', 1 => 'pspell_save_wordlist', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pspell/functions/pspell-new-personal.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pspell_new_personal

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

pspell_new_personal — Carrega um novo dicionário com lista de palavras pessoal

Descrição

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

pspell_new_personal() abre um novo dicionário com uma lista de palavras pessoal. A lista de palavras pode ser modificada e salva com pspell_save_wordlist(), se desejado. No entanto, os pares de substituição não são salvos. Para salvar os pares de substituição, deve-se criar uma configuração usando pspell_config_create(), definir o arquivo da lista de palavras pessoal com pspell_config_personal(), definir o arquivo para pares de substituição com pspell_config_repl() e abrir um novo dicionário com pspell_new_config().

Para mais informações e exemplos, confira o manual do site do pspell:» http://aspell.net/.

Parâmetros

filename

O arquivo onde as palavras adicionadas à lista pessoal serão armazenadas. Deve ser um nome de arquivo absoluto começando com '/', pois, caso contrário, será relativo a $HOME, que é "/root" para a maioria dos sistemas, e provavelmente não é o que se deseja.

language

O código de idioma consiste no código de idioma ISO 639 de duas letras e um código de país ISO 3166 opcional de duas letras após um hífen ou sublinhado.

spelling

A grafia solicitada para idiomas com mais de uma grafia, como o inglês. Os valores conhecidos são 'american', 'british' e 'canadian'.

jargon

Informações extras para distinguir duas listas de palavras diferentes que têm os mesmos parâmetros de idioma e ortografia.

encoding

A codificação em que se espera que as palavras estejam. Os valores válidos são utf-8, iso8859-*, koi8-r, viscii, cp1252, machine unsigned 16, machine unsigned 32.

mode

O modo como o corretor ortográfico funcionará. Há vários modos disponíveis:

  • PSPELL_FAST - Modo rápido (menor número de sugestões)
  • PSPELL_NORMAL - Modo normal (mais sugestões)
  • PSPELL_BAD_SPELLERS - Modo lento (muitas sugestões)
  • PSPELL_RUN_TOGETHER - Considera palavras que se juntam como palavras compostas legais. Ou seja, "thecat" será uma palavra composta legal em inglês, embora deva haver um espaço entre as duas palavras. Alterar esta configuração afeta apenas os resultados retornados por pspell_check(); pspell_suggest() ainda retornará sugestões.
Mode é uma máscara de bits construída a partir das diferentes constantes listadas acima. No entanto, PSPELL_FAST, PSPELL_NORMAL e PSPELL_BAD_SPELLERS são mutuamente exclusivas, portanto, deve-se selecionar apenas uma delas.

Valor Retornado

Retorna uma instância de PSpell\Dictionary em caso de sucesso, ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 Agora, retorna uma instância de PSpell\Dictionary; anteriormente, um resource era retornado.

Exemplos

Exemplo #1 pspell_new_personal()

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