[Funciones PHP] La función wordwrap()

La función “wordwrap()”, que está disponible para las versiones de PHP 4.0.3 y superiores, ajusta una cadena de caracteres a un número determinado. Esta función nos retorna un string con el formato que le hemos indicado a la función “wordwrap()”.

El formato de la función es la siguiente:

• wordwrap ( Cadena de caracteres [String], Ancho de la nueva cadena que queremos [Entero], Cadena de la ruptura [String], Ruptura [Booleana] )

Los parámetros básicos que le debemos indicar a ésta función son:

• El primer parámetro que debemos de indicarle a la función “wordwrap()” es la cadena de caracteres que queremos modificar.
• El segundo valor que debemos indicarle a ésta función es numérico y es el ancho de caracteres que deseamos en la nueva cadena de caracteres.

Un ejemplo básico del uso de la función “wordwrap()” es el siguiente:

Si deseamos modificar el “\n” que le inserta automáticamente por otro tipo de salto de línea cómo puede ser <br />, que realiza un salto de línea en HTML. La función quedaría de la siguiente manera:

• wordwrap ( Cadena de caracteres, Ancho de la nueva que queremos, , “<br />\n”)

Hay que tener en cuenta que en éste caso “wordwrap()” no nos dividirá una palabra aunque el ancho de la línea sea superior. Un ejemplo puede ser el siguiente:

<?php
//Definimos el texto original
$texto = “Esto es una prueba del funcionamiento de la función wordwrap() de PHP”;
//Usamos la función “wordwrap()” para modificar el texto original ósea la variable $texto.
$nuevotexto = wordwrap($texto, 10, “<br />\n”);
//Mostramos la cadena de texto modificada por “wordwrap()”
echo $nuevotexto ;
?>

El resultado será el siguiente:

Esto es<br />
una prueba<br />
del<br />
funcionamiento<br />
de la<br />
función<br />
wordwrap()<br />
de PHP

Finalmente y como último parámetro que le podemos pasar a “wordwrap()” es el valor de ruptura o “Cut”, éste parámetro es Booleano y cuando su valor es:

• true, si éste parámetro es true corta las palabras, manteniendo el ancho que le hemos indicado al segundo valor.
• false, cuando el parámetro “cut” es false conserva completas las palabras de la línea, aunque exceda el ancho de la línea que le hemos indicado, si no se indica ningún valor, “cut” predeterminadamente es false.

Ejemplo cuando “cut” es true, el código PHP será de la siguiente manera:

<?php
//Definimos el texto original
$texto = “Esto es una prueba del funcionamiento de la función wordwrap()!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!”;

//Usamos la función “wordwrap()” para modificar el texto original ósea la variable $texto.
$nuevotexto = wordwrap($texto, 10, “<br />\n”, true);
//Mostramos la cadena de texto modificada por “wordwrap()”
echo $nuevotexto ;
?>

El resultado es el siguiente cuando el parámetro “cut” es true:

Esto es<br />
una prueba<br />
del<br />
funcionami<br />
ento de la<br />
función<br />
wordwrap()<br />
!!!!!!!!!!<br />
!!!!!!!!!!<br />
!!!!!!!!!!<br />
!

Cuando “cut” es false el código PHP quedará de la siguiente manera:

<?php
//Definimos el texto original
$texto = “Esto es una prueba del funcionamiento de la función wordwrap()!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!”;
//Usamos la función “wordwrap()” para modificar el texto original ósea la variable $texto.
$nuevotexto = wordwrap($texto, 10, ”
\n”, false);
//Mostramos la cadena de texto modificada por “wordwrap()”
echo $nuevotexto ;
?>

El resultado de éste código es el siguiente:

Esto es
una prueba
del
funcionamiento
de la
función
wordwrap()!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!