# 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

- nl2br() - Fügt vor allen Zeilenumbrüchen eines Strings HTML-Zeilenumbrüche ein
- chunk_split() - Zerlegt einen String in Teile gleicher Länge

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open