# ps_hyphenate

(PECL ps >= 1.1.1)

ps_hyphenate — Particionar silábicamente una palabra

### Descripción

ps_hyphenate(resource `$psdoc`, string `$text`): array

Particiona silábicamente la palabra proporcionada. ps_hyphenate() evalúa el valor "hyphenminchars" (establecido mediante la función ps_set_value()) y el parámetro "hyphendict" (establecido mediante la función ps_set_parameter()). "hyphendict" debe establecerse antes de llamar a esta función.

Esta función requiere que la categoría de configuración regional LC_CTYPE sea establecida correctamente. Esto se realiza cuando la extensión se inicializa utilizando las variables de entorno. Lea el manual de 'locale' de sistemas Unix para más información.

### Parámetros

`psdoc`

  El identificador de recursos del fichero postscript, como el devuelto por la función ps_new().

`text`

  `text` no debería contener ningún carácter que no sea una letra. Las posiciones posibles para las divisiones son devueltas en un array de números enteros. Cada número es la posición del carácter de `text` después del cual puede tomar lugar una partición silábica.

### Valores devueltos

Un array de enteros indicando la posición de posibles divisiones del texto o `false` en caso de error.

### Ejemplos

Ejemplo #1 Particionar silábicamente un texto

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

El resultado del ejemplo sería:

    Ko-ordi-na-ten-sys-tem

### Ver también

- ps_show_boxed() - Imprimir texto en una caja
- locale(1)