nl2br

(PHP 4, PHP 5, PHP 7)

nl2brInserta saltos de línea HTML antes de todas las nuevas líneas de un string

Descripción

nl2br ( string $string [, bool $is_xhtml = TRUE ] ) : string

Devuelve el parámetro string con un <br /> o <br> insertado antes de cada nueva línea. (\r\n, \n\r, \n y \r).

Parámetros

string

El string de entrada.

is_xhtml

Si utilizar saltos de línea compatibles con XHTML o no.

Valores devueltos

Devuelve el string alterado.

Ejemplos

Ejemplo #1 Usar nl2br()

<?php
echo nl2br("foo no es\n bar");
?>

El resultado del ejemplo sería:

foo no es<br />
 bar

Ejemplo #2 Generar marcado HTML válido utilizando el parámetro is_xhtml

<?php
echo nl2br("Bienvenido\r\nEste es mi documento HTML"false);
?>

El resultado del ejemplo sería:

Bienvenido<br>
Este es mi documento HTML

Ejemplo #3 Varios separadores de nueva línea

<?php
$cadena 
"Esto\r\nes\n\runa\ncadena\r";
echo 
nl2br($cadena);
?>

El resultado del ejemplo sería:

Esto<br />
es<br />
una<br />
cadena<br />

Historial de cambios

Versión Descripción
5.3.0 Se agregó el parámetro opcional is_xhtml. Antes de esta versión, siempre se insertaba '<br />'.

Ver también

  • htmlspecialchars() - Convierte caracteres especiales en entidades HTML
  • htmlentities() - Convierte todos los caracteres aplicables a entidades HTML
  • wordwrap() - Ajusta un string hasta un número dado de caracteres
  • str_replace() - Reemplaza todas las apariciones del string buscado con el string de reemplazo