Effectue la césure d'un mot

# ps_hyphenate

(PECL ps >= 1.1.1)

ps_hyphenate — Effectue la césure d'un mot

### Description

function 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 hyphendict (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

- ps_show_boxed() - Écriture de texte dans une boîte
- locale(1)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open