الدالة nl2br() في PHP
< 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).
المعاملات
str
السلسلة النصية المُدخلة.
is_xhtml
لبيان ضرورة استعمال الوسوم المتوافقة مع لغة 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، كان الوسم <br /> يُضاف دائمًا قبل ذلك.
|
انظر أيضًا
htmlspecialchars(): تَحوِيل المحارف الخاصة إلى مدخلات HTML.htmlentities(): تَحوِيل المحارف إلى مدخلات HTML.str_replace(): تغيير كل أماكن وجود السلسلة النصية المبحوث عنها ضمن سلسلة نصية إلى سلسلة نصية أخرى.wordwrap(): إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف.