array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ps-hyphenate.php', 1 => 'ps_hyphenate', 2 => 'Hifeniza uma palavra', ), 'up' => array ( 0 => 'ref.ps.php', 1 => 'Funções de PS', ), 'prev' => array ( 0 => 'function.ps-get-value.php', 1 => 'ps_get_value', ), 'next' => array ( 0 => 'function.ps-include-file.php', 1 => 'ps_include_file', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ps/functions/ps-hyphenate.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ps_hyphenate

(PECL ps >= 1.1.1)

ps_hyphenate — Hifeniza uma palavra

Descrição

ps_hyphenate(resource $psdoc, string $text): array|false

Hifeniza a palavra passada. ps_hyphenate() avalia o valor hyphenminchars (definido por ps_set_value()) e o parâmetro hyphendict (definido por ps_set_parameter()). hyphendict deve ser definido antes de chamar esta função.

Esta função requer que a categoria de localidade LC_CTYPE seja definida corretamente. Isso é feito quando a extensão é inicializada usando as variáveis de ambiente. Em sistemas Unix, leia a página de manual de "locale" para mais informações.

Parâmetros

psdoc

Identificador de recurso do arquivo postscript conforme retornado por ps_new().

text

text não deve conter caracteres não alfabéticos. Posições possíveis para quebras são retornadas em um array de números inteiros. Cada número é a posição do caractere em text após o qual uma hifenização pode ocorrer.

Valor Retornado

Um array de inteiros indicando a posição de possíveis quebras no texto ou false em caso de falha.

Exemplos

Exemplo #1 Hifenizando um texto

<?php
$word = "Koordinatensystem";
$psdoc = ps_new();
ps_set_parameter($psdoc, "hyphendict", "hyph_de.dic");
$hyphens = ps_hyphenate($psdoc, $word);
for($i=0; $i<strlen($word); $i++) {
echo $word[$i];
if(in_array($i, $hyphens))
echo "-";
}
ps_delete($psdoc);
?>

O exemplo acima produzirá:

Ko-ordi-na-ten-sys-tem

Veja Também