الفرق بين المراجعتين ل"PHP/nl2br"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
هارون-بوكرش (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة nl2br() في PHP}}</noinclude>') |
هارون-بوكرش (نقاش | مساهمات) |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة nl2br() في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة nl2br() في PHP}}</noinclude> | ||
+ | (PHP 4, PHP 5, PHP 7) | ||
+ | |||
+ | تُضيف الدالة nl2br() العنصر <nowiki><br></nowiki> في لغة HTML قبل كل سطر في السلسلة النصية. | ||
+ | |||
+ | === الوصف === | ||
+ | <syntaxhighlight lang="php"> | ||
+ | string nl2br ( string $string [, bool $is_xhtml = TRUE ] ) | ||
+ | </syntaxhighlight>تُعيد الدالة nl2br() سلسلة نصية تحتوي على العنصر <nowiki><br></nowiki> قبل كل سطر فيها (\r\n و \n\r و \n و \r). | ||
+ | |||
+ | === المعاملات === | ||
+ | |||
+ | ==== str ==== | ||
+ | السلسلة النصية المُدخلة. | ||
+ | |||
+ | ==== is_xhtml ==== | ||
+ | لبيان ضرورة استعمال الوسوم المتوافقة مع لغة XHTML من عدمه (أي استخدام <br /> بدلًا من <nowiki><br></nowiki>). | ||
+ | |||
+ | === القيم المعادة === | ||
+ | إعادة السلسلة النصية المُغيرة. | ||
+ | |||
+ | === أمثلة === | ||
+ | |||
+ | ==== المثال 1: مثال عن استعمال الدالة nl2br() ==== | ||
+ | <syntaxhighlight lang="php"> | ||
+ | <?php | ||
+ | |||
+ | echo nl2br("foo isn't\n bar"); | ||
+ | |||
+ | ?> | ||
+ | |||
+ | |||
+ | </syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="php"> | ||
+ | foo isn't<br /> | ||
+ | bar | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | ==== المثال 2: مثال عن استعمال الدالة nl2br() بوسوم متوافقة مع لغة XHTML باستخدام المعامل is_xhtml ==== | ||
+ | <syntaxhighlight lang="php"> | ||
+ | <?php | ||
+ | |||
+ | echo nl2br("Welcome\r\nThis is my HTML document", false); | ||
+ | |||
+ | ?> | ||
+ | |||
+ | |||
+ | </syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="php"> | ||
+ | Welcome<br> | ||
+ | |||
+ | This is my HTML document | ||
+ | |||
+ | |||
+ | </syntaxhighlight>المثال 3: أمثلة عن استعمال مختلف أنواع نهايات الأسطر (يونكس وويندوز)<syntaxhighlight lang="php"> | ||
+ | <?php | ||
+ | |||
+ | $string = "This\r\nis\n\ra\nstring\r"; | ||
+ | |||
+ | echo nl2br($string); | ||
+ | |||
+ | ?> | ||
+ | |||
+ | |||
+ | </syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="php"> | ||
+ | This<br /> | ||
+ | |||
+ | is<br /> | ||
+ | |||
+ | a<br /> | ||
+ | |||
+ | string<br /> | ||
+ | |||
+ | |||
+ | </syntaxhighlight> | ||
+ | |||
+ | === سجل التغييرات === | ||
+ | {| class="wikitable" | ||
+ | |الإصدار | ||
+ | |الوصف | ||
+ | |- | ||
+ | |5.3.0 | ||
+ | |أُضيف المعامل is_xhtml، كان الوسم<br /> يُضاف دائمًا قبل ذلك. | ||
+ | |} | ||
+ | |||
+ | === انظر أيضًا === | ||
+ | * htmlspecialchars(): تَحوِيل المحارف الخاصة إلى مدخلات HTML. | ||
+ | * htmlentities(): تَحوِيل المحارف إلى مدخلات HTML. | ||
+ | * str_replace(): تغيير كل أماكن وجود السلسلة النصية المبحوث عنها ضمن سلسلة نصية إلى سلسلة نصية أخرى. | ||
+ | * wordwrap(): إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف. | ||
+ | |||
+ | === مصادر === | ||
+ | * صفحة الدالة nl2br في توثيق PHP الرسمي. |
مراجعة 14:04، 5 أبريل 2018
(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(): إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف.
مصادر
- صفحة الدالة nl2br في توثيق PHP الرسمي.