wordwrap

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

wordwrapRealiza el ajuste de línea de un string

Descripción

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 resultado del ejemplo sería:

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 resultado del ejemplo sería:

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 resultado del ejemplo sería:

A very
long
woooooooooooooooooord.
and
something

Ver también