nl2br
(PHP 4, PHP 5)
nl2br — Inserta saltos de línea HTML antes de todas las nuevas líneas de un string
Descripción
string nl2br
( string
$string
[, bool $is_xhtml = true
] )
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