array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.ps-hyphenate.php', 1 => 'ps_hyphenate', 2 => 'Relie un mot', ), 'up' => array ( 0 => 'ref.ps.php', 1 => 'Fonctions 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' => 'fr', '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 — Relie un mot

Description

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

Effectue la césure du mot passé. ps_hyphenate() évalue la valeur hyphenminchars (fixé par ps_set_value()) et le paramètre hyphendic (fixé par ps_set_parameter()). hyphendict doit être fixé avant d'appeler cette fonction.

Cette fonction requiert que la configuration locale LC_CTYPE soit correctement faite. Cela est fait lorsque l'extension est initialisée en utilisant les variables d'environnement. Sur les systèmes Unix, lisez les pages de manuel de locale pour plus d'informations.

Liste de paramètres

psdoc

Identifiant d'un fichier postscript retourné par ps_new().

text

text ne devrait pas contenir de caractères non alpha. Les positions possibles pour les coupures sont retournées dans un tableau de nombre entier. Chaque nombre est la position du caractère dans text après lequel une césure peut avoir lieu.

Valeurs de retour

Un tableau d'entiers indiquant la position des coupures possibles dans le texte ou false si une erreur survient.

Exemples

Exemple #1 Coupe un texte

<?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);
?>

L'exemple ci-dessus va afficher :

Ko-ordi-na-ten-sys-tem

Voir aussi