array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.wordwrap.php', 1 => 'wordwrap', 2 => 'Umbricht einen String nach einer bestimmten Anzahl Zeichen', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.vsprintf.php', 1 => 'vsprintf', ), 'next' => array ( 0 => 'changelog.strings.php', 1 => 'Changelog', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/strings/functions/wordwrap.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

wordwrap

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

wordwrap — Umbricht einen String nach einer bestimmten Anzahl Zeichen

Beschreibung

wordwrap(
    string $string,
    int $width = 75,
    string $break = "\n",
    bool $cut_long_words = false
): string

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.

Parameter-Liste

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.

Rückgabewerte

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

Fehler/Exceptions

Wenn break eine leere Zeichenkette ist, wird ein ValueError geworfen.

Changelog

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.

Beispiele

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.

Siehe auch