PHP Handbuch
Zurück |  | Weiter

# ps_hyphenate

(PECL)

ps_hyphenate -- Hyphenates a word

## Beschreibung

array ps_hyphenate ( resource psdoc, string text )

Hyphenates the passed word. ps_hyphenate() evaluates the value hyphenminchars (set by ps_set_value()) and the parameter hyphendict (set by ps_set_parameter()). hyphendict must be set before calling this function.

This function requires the locale category LC_CTYPE to be set properly. This is done when the extension is initialized by using the environment variables. On Unix systems read the man page of locale for more information.

## Parameter Liste

psdoc

  Resource identifier of the postscript file as returned by ps_new().

text

  text should not contain any non alpha characters. Possible positions for breaks are returned in an array of interger numbers. Each number is the position of the char in text after which a hyphenation can take place.

## Rückgabewerte

An array of integers indicating the position of possible breaks in the text or `FALSE` in case of an error.

## Beispiele

Beispiel 1. Hyphennate a text
`<?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); ?>`
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
    Ko-ordi-na-ten-sys-tem

## Siehe auch

ps_show_boxed()
locale(1)

Zurück | Zum Anfang | Weiter
ps_get_value | Nach oben | ps_lineto