Documentación offline PHP master

wordwrap

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

wordwrap

Realiza el ajuste de línea de un string

Descripción#

wordwrap(string $string, [int $width], [string $break], [bool $cut_long_words]): string
```php

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 con `wordwrap`
\n"); echo $newtext; ?>
El ejemplo anterior mostrará:

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

Ejemplo con `wordwrap`
El ejemplo anterior mostrará:

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

Ejemplo con `wordwrap`

```php

El ejemplo anterior mostrará:

A very
long
woooooooooooooooooord.
and
something

Véase también#

nl2br, chunk_split