nl2br

(PHP 4, PHP 5, PHP 7, PHP 8)

nl2brInsere quebras de linha HTML antes de todos os caracteres de nova linha em um string

Descrição

nl2br(string $string, bool $use_xhtml = true): string

Retorna a string com <br /> ou <br> inseridos antes de todas os caracteres de nova linha (\r\n, \n\r, \n e \r).

Parâmetros

string

A string de entrada.

use_xhtml

Informa se devem ser usadas quebras de linha compatíveis com XHTML ou não.

Valor Retornado

Retorna a string modificada.

Exemplos

Example #1 Usando nl2br()

<?php
echo nl2br("isto não é\n aquilo");
?>

O exemplo acima produzirá:

isto não é<br />
 aquilo

Example #2 Grando marcação HTML válida usando o parâmetro use_xhtml

<?php
echo nl2br("Bem-vindo\r\nEste é meu documento HTML", false);
?>

O exemplo acima produzirá:

Bem-vindo<br>
Este é meu documento HTML

Example #3 Vários separadores de linha

<?php
$string = "Isto\r\né\n\ruma\nstring\r";
echo nl2br($string);
?>

O exemplo acima produzirá:

Isto<br />
é<br />
uma<br />
string<br />

Veja Também

  • htmlspecialchars() - Converte caracteres especiais para entidades HTML
  • htmlentities() - Converte todos os caracteres aplicáveis em entidades HTML
  • wordwrap() - Quebra uma string em um dado número de caracteres
  • str_replace() - Substitui todas as ocorrências da string de pesquisa com a string de substituição