الفرق بين المراجعتين ل"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، كان الوسم<b‎r /‎> يُضاف دائمًا قبل ذلك.
 +
|}
 +
 +
=== انظر أيضًا ===
 +
* 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، كان الوسم<b‎r /‎> يُضاف دائمًا قبل ذلك.

انظر أيضًا

  • htmlspecialchars()‎: تَحوِيل المحارف الخاصة إلى مدخلات HTML.
  • htmlentities()‎: تَحوِيل المحارف إلى مدخلات HTML.
  • str_replace()‎: تغيير كل أماكن وجود السلسلة النصية المبحوث عنها ضمن سلسلة نصية إلى سلسلة نصية أخرى.
  • wordwrap()‎: إجراء التفاف للسلسلة النصيَّة الممرَّرة إليها عند عدد محدَّد من المحارف.

مصادر

  • صفحة الدالة nl2br في توثيق PHP الرسمي.
مجلوبة من "https://wiki.hsoub.com/index.php?title=PHP/nl2br&oldid=5736"