(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
wordwrap — Umbricht einen String nach einer bestimmten Anzahl Zeichen
$string
,$width
= 75,$break
= "\n",$cut_long_words
= false
Umbricht einen String nach einer bestimmten Anzahl Zeichen mittels eines
angegebenen Trennzeichens.
Wenn cut_long_words
nicht auf true
gesetzt ist,
werden Zeichenketten nach einem Leerzeichen (U+0020) umbrochen.
string
Die Eingabezeichenkette.
width
Die Anzahl von Zeichen nach denen die Zeichenkette umbrochen wird.
break
Der optionale Parameter break
wird als
Zeichen(kette) für den Zeilenumbruch verwendet; darf keine leere
Zeichenkette sein.
cut_long_words
Wenn der Parameter cut_long_words
auf true
gesetzt ist, wird die Zeichenkette spätestens nach der angegebenen
width
umbrochen. 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). Bei false
trennt
die Funktion das Wort nicht, selbst wenn der
width
kleiner ist als die Wortlänge.
Gibt die übergebene Zeichenkette zurück, die an der angegebenen Trennstelle umbrochen wurde.
Wenn break
eine leere Zeichenkette ist, wird ein
ValueError geworfen.
Version | Beschreibung |
---|---|
8.0.0 |
Wenn break eine leere Zeichenkette ist, wird ein
ValueError geworfen; zuvor wurde in diesem Fall
ein E_WARNING ausgegeben und false zurückgegeben.
|
Beispiel #1 wordwrap()-Beispiel
$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.
Beispiel #2 wordwrap()-Beispiel
$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.
Beispiel #3 wordwrap()-Beispiel
<?php
$text = "Ein sehr langes Woooooooooooooooooort. Und noch mehr.";
$newtext = wordwrap($text, 8, "\n", false);
echo "$newtext\n";
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Ein sehr langes Woooooooooooooooooort. Und noch mehr.