wordwrap

(PHP 4 >= 4.0.2, PHP 5)

wordwrap --  Bricht die Zeilen eines Strings nach einer bestimmten Anzahl Zeichen mittels des angegebenen Trennzeichens um.

Beschreibung:

string wordwrap ( string str [, int width [, string break [, int cut]]])

Bricht die Zeilen des Strings str an der mittels width angegebenen Position um. Diese Zeilenumbrüche werden mit dem im (optionalen) Parameter break spezifizierten Steuerzeichen durchgeführt.

Die Funktion wordwrap() bricht die Zeilen automatisch an der Spalte 75 unter Verwendung des Steuerzeichens '\n' (neue Zeile) um, wenn die optionalen Parameter width und / oder break nicht angegeben sind.

Steht cut auf 1, wird der String immer an der vorgegebenen Länge umgebrochen. Ist ein Wort also länger als die gegebene Länge, wird der Zeilumbruch auch innerhalb des Wortes eingefügt (siehe zweites Beispiel).

Anmerkung: Der optionale Parameter cut wurde in PHP 4.0.3 eingeführt.

Beispiel 1. wordwrap()-Beispiel:

$text = "Der schnelle braune Fuchs sprang über den faulen Hund.";
$neuertext = wordwrap( $text, 20 );

echo "$neuertext\n";

Dieses Beispiel gibt aus:

Der schnelle braune 
Fuchs sprang über 
den faulen Hund.

Beispiel 2. wordwrap() example

$text = "Ein sehr langes Wooooooooooort.";
$neuertext = wordwrap( $text, 8, "\n", 1);

echo "$neuertext\n";

Dieses Beispiel gibt aus:

Ein sehr
langes
Wooooooo
oooort.

Siehe auch nl2br().