الدالة nl2br() في PHP
< PHP
اذهب إلى التنقل
اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
(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(): إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف.