(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
wordwrap — Realiza el ajuste de línea de un string
$string
,$width
= 75,$break
= "\n",$cut_long_words
= false
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
.
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.
Devuelve el string proporcionado cortado a la longitud especificada.
Si break
es un string vacío, se lanza una ValueError.
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 .
|
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