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