الفرق بين المراجعتين لصفحة: «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(): إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف.