الدالة `nl2br()‎` في PHP

(PHP 4, PHP 5, PHP 7)

تُضيف الدالة nl2br()‎ العنصر <br> في لغة HTML قبل كل سطر في السلسلة النصية.

الوصف

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

تُعيد الدالة nl2br()‎ سلسلة نصية تحتوي على العنصر <br> قبل كل سطر فيها (يُشار إلى السطر الجديد بالرموز ‎\r\n و ‎\n\r و ‎\n و ‎\r).

السلسلة النصية المُدخلة.

لبيان ضرورة استعمال الوسوم المتوافقة مع لغة XHTML من عدمه (أي استخدام <‎br /‎> بدلًا من <br>).

إعادة السلسلة النصية المُغيرة.

المثال 1: مثال عن استعمال الدالة nl2br()‎

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

يُعيد المثال السابق ما يلي:

foo isn't<br />
 bar

المثال 2: مثال عن استعمال الدالة nl2br()‎ بوسوم متوافقة مع لغة XHTML باستخدام المعامل is_xhtml

<?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 />

الإصدار	الوصف
5.3.0	أُضيف المعامل `is_xhtml`، كان الوسم `<b‎r /‎>` يُضاف دائمًا قبل ذلك.

htmlspecialchars()‎: تَحوِيل المحارف الخاصة إلى مدخلات HTML.
htmlentities()‎: تَحوِيل المحارف إلى مدخلات HTML.
str_replace()‎: تغيير كل أماكن وجود السلسلة النصية المبحوث عنها ضمن سلسلة نصية إلى سلسلة نصية أخرى.
wordwrap()‎: إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف.