Function.wordwrap

Aus PHP-Wiki

wordwrap — Bricht einen String nach einer bestimmten Anzahl Zeichen um

Beschreibung

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

Bricht einen String nach einer bestimmten Anzahl Zeichen mittels eines angegebenen Trennzeichens um.

Parameter-Liste

str

• Die Eingabezeichenkette.

width

• Die Spaltenbreite des Umbruchs. Standardwert sind 75 Zeichen.

break

• Der optionale Parameter break wird als Zeichen(kette) für den Zeilenumbruch verwendet. Standardwert ist '\n'.

cut

• Wenn der Parameter cut auf TRUE gesetzt ist, wird die Zeichenkette immer nach der angegebenen Länge umgebrochen. Wenn sie also ein Wort haben, das länger als die angegebene Maximallänge ist, wird der Umbruch im Wort selbst durchgeführt (siehe zweites Beispiel).

Rückgabewerte

Gibt die übergebene Zeichenkette zurück, die an der angegebenen Trennstelle umgebrochen wurde.

ChangeLog

Version Beschreibung 4.0.3 Der optionale Parameter cut wurde hinzugefügt.

Beispiele

#1 wordwrap()

$text = "Der schnelle braune Fuchs sprang über den faulen Hund.";
$neuertext = wordwrap( $text, 20, "<br />\n" );
 
echo $neuertext;

Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:

Der schnelle braune<br />
Fuchs sprang über<br />
den faulen Hund.

#2 wordwrap()

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

Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:

Ein sehr
langes
Wooooooo
oooort.

Siehe auch

• nl2br()
• chunk_split()