(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
pspell_new_personal — Carrega um novo dicionário com lista de palavras pessoal
$filename
,$language
,$spelling
= "",$jargon
= "",$encoding
= "",$mode
= 0pspell_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/.
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.
PSPELL_FAST
,
PSPELL_NORMAL
e
PSPELL_BAD_SPELLERS
são mutuamente exclusivas, portanto,
deve-se selecionar apenas uma delas.
Retorna uma instância de PSpell\Dictionary em caso de sucesso, ou false
em caso de falha.
Versão | Descrição |
---|---|
8.1.0 | Agora, retorna uma instância de PSpell\Dictionary; anteriormente, um resource era retornado. |
Exemplo #1 pspell_new_personal()
<?php
$pspell = pspell_new_personal ("/var/dictionaries/custom.pws",
"en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER);
?>