# wordwrap

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

wordwrap — Ajusta un string hasta un número dado de caracteres

### Descripción

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

Ajusta un string hasta un número dado de caracteres utilizando un caracter de salto de string.

### Parámetros

`str`

  El string de entrada.

`width`

  El número de caracteres en el cual el string se verá envuelto.

`break`

  La línea se rompe utilizando el parámetro opcional `break`.

`cut`

  Si `cut` se establece en `true`, el string siempre será ajustado en o antes del `width` especificado. De tal forma que si se tiene una palabra que es más larga que el ancho dado, será dividida (ver segundo ejemplo). Cuando es `false` la función no divide la palabra incluso si `width` es menor que el ancho de la palabra.

### Valores devueltos

Devuelve el string dado ajustado a la longitud especificada.

### Ejemplos

Ejemplo #1 Ejemplo de wordwrap()

`<?php
$text = "The quick brown fox jumped over the lazy dog.";
$newtext = wordwrap($text, 20, "<br />\n");
echo $newtext;
?>`

El resultado del ejemplo sería:

    The quick brown fox<br />
    jumped over the lazy<br />
    dog.

Ejemplo #2 Ejemplo de wordwrap()

`<?php
$text = "A very long woooooooooooord.";
$newtext = wordwrap($text, 8, "\n", true);
echo "$newtext\n";
?>`

El resultado del ejemplo sería:

    A very
    long
    wooooooo
    ooooord.

Ejemplo #3 Ejemplo de wordwrap()

`<?php
$texto = "A very long woooooooooooooooooord. and something";
$nuevo_texto = wordwrap($texto, 8, "\n", false);
echo "$nuevo_texto\n";
?>`

El resultado del ejemplo sería:

    A very
    long
    woooooooooooooooooord.
    and
    something

### Ver también

- nl2br() - Inserta saltos de línea HTML antes de todas las nuevas líneas de un string
- chunk_split() - Divide una cadena en trozos más pequeños