nl2br

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

nl2br改行文字の前に HTML の改行タグを挿入する

説明

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

string に含まれるすべての改行文字 (\r\n\n\r\n および \r) の前に <br /> あるいは <br> を挿入して返します。

パラメータ

string

入力文字列。

use_xhtml

XHTML 準拠の改行を使うか否か。

戻り値

変更後の文字列を返します。

例1 nl2br() の使用法

<?php
echo nl2br("foo isn't\n bar");
?>

上の例の出力は以下となります。

foo isn't<br />
 bar

例2 use_xhtml パラメータを使い、妥当な HTML 形式のマークアップを生成する

<?php
echo nl2br("Welcome\r\nThis is my HTML document"false);
?>

上の例の出力は以下となります。

Welcome<br>
This is my HTML document

例3 さまざまな改行文字

<?php
$string 
"This\r\nis\n\ra\nstring\r";
echo 
nl2br($string);
?>

上の例の出力は以下となります。

This<br />
is<br />
a<br />
string<br />

参考

  • htmlspecialchars() - 特殊文字を HTML エンティティに変換する
  • htmlentities() - 適用可能な文字を全て HTML エンティティに変換する
  • wordwrap() - 指定した文字数で文字列を分割する
  • str_replace() - 検索文字列に一致したすべての文字列を置換する

関連キーワード:  改行, 文字, 挿入, タグ, string, 出力, use, エンティティ, 変換, This