Realiza el ajuste de línea de un string

# wordwrap

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

wordwrap — Realiza el ajuste de línea de un string

### Descripción

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

Realiza el ajuste de línea de un string. Los strings se cortan después de un carácter de espacio (U+0020) a menos que `cut_long_words` esté definido como `true`.

### Parámetros

`string`

  El string de entrada.

`width`

  El número de caracteres a partir del cual el string será cortado.

`break`

  La línea se rompe utilizando `break`, este parámetro opcional. No debe ser un string vacío.

`cut_long_words`

  Si el parámetro `cut_long_words` vale `true`, el ajuste de línea del string se realizará siempre al tamaño `width` o antes. Si se tiene una palabra que es más larga que el tamaño de ajuste, será cortada en trozos: ver el segundo ejemplo. Cuando vale `false`, la función no cortará la palabra, incluso si el parámetro `width` es más pequeño que el tamaño de la palabra.

### Valores devueltos

Devuelve el string proporcionado cortado a la longitud especificada.

### Errores/Excepciones

Si `break` es un string vacío, se lanza una ValueError.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | Si `break` es un string vacío, se lanza una ValueError; anteriormente, en este caso, se emitía un `E_WARNING` y se devolvía `false`.

### Ejemplos

Ejemplo #1 Ejemplo con wordwrap()

    <?php
    $text = "Portez ce vieux whisky au juge blond qui fume.";
    $newtext = wordwrap($text, 20, "<br />\n");

    echo $newtext;
    ?>

El ejemplo anterior mostrará:

    Portez ce vieux<br />
    whisky au juge<br />
    blond qui fume.

Ejemplo #2 Ejemplo con wordwrap()

    <?php
    $text = "Un mot très très loooooooooooooooooong.";
    $newtext = wordwrap($text, 8, "\n", true);

    echo "$newtext\n";
    ?>

El ejemplo anterior mostrará:

    Un mot
    très
    très
    looooooo
    oooooooo
    ooong.

Ejemplo #3 Ejemplo con wordwrap()

    <?php
    $text = "A very long woooooooooooooooooord. and something";
    $newtext = wordwrap($text, 8, "\n", false);

    echo "$newtext\n";
    ?>

El ejemplo anterior mostrará:

    A very
    long
    woooooooooooooooooord.
    and
    something

### Ver también

- nl2br() - Inserta un salto de línea HTML en cada nueva línea
- chunk_split() - Divide un string

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