الفرق بين المراجعتين لصفحة: «PHP/highlight string»
< PHP
المساهمة في ترجمة الصفحة |
رؤيا-بنعطية (نقاش | مساهمات) تعديلات طفيفة على التنسيق |
||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>highlight_string()</code> في PHP}}</noinclude> | |||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تلوّن الدالةُ highlight_string() شيفرات PHP في سلسلة نصية. | تلوّن الدالةُ <code>highlight_string()</code> شيفرات PHP في سلسلة نصية. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
mixed highlight_string ( string $str [, bool $return = FALSE ] ) | mixed highlight_string ( string $str [, bool $return = FALSE ] ) | ||
</syntaxhighlight>تطبع أو تعيد الدالةُ highlight_string() ترميزَ html لإصدارٍ ملونٍ من شيفرات PHP المعطاة باستخدام الألوان المُعرَّفة في ملوِّن الشيفرات المدمج في PHP. | </syntaxhighlight>تطبع أو تعيد الدالةُ <code>highlight_string()</code> ترميزَ [[HTML|html]] لإصدارٍ ملونٍ من شيفرات PHP المعطاة باستخدام الألوان المُعرَّفة في ملوِّن الشيفرات المدمج في PHP. | ||
== المعاملات == | == المعاملات == | ||
=== str === | === <code>str</code> === | ||
شيفرة PHP المراد تلوينها. يجب أن تتضمن هذه الشيفرة وسمَ الفتح. | شيفرة PHP المراد تلوينها. يجب أن تتضمن هذه الشيفرة وسمَ الفتح. | ||
=== return === | === <code>return</code> === | ||
ضبط المعامل return إلى القيمة TRUE سيؤدي إلى إعادة الدالة highlight_string() للشيفرة الملوّنة بدل طباعتها مباشرةً. | ضبط المعامل <code>return</code> إلى القيمة <code>TRUE</code> سيؤدي إلى إعادة الدالة <code>highlight_string()</code> للشيفرة الملوّنة بدل طباعتها مباشرةً. | ||
== القيم المعادة == | == القيم المعادة == | ||
إذا ضُبِطَ المعامل return إلى القيمة | إذا ضُبِطَ المعامل <code>return</code> إلى القيمة <code>TRUE</code>، فستُعاد الشيفرة الملونة كسلسلة نصية بدلًا من طباعتها. وإلا، فستُعاد القيمة <code>TRUE</code> عند النجاح، والقيمة <code>FALSE</code> عند الفشل. | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال على الدالة highlight_string()<syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>highlight_string()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
highlight_string('<?php phpinfo(); ?>'); | highlight_string('<?php phpinfo(); ?>'); | ||
?> | ?> | ||
</syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang=" | </syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang="text"> | ||
<code><span style="color: #000000"> | <code><span style="color: #000000"> | ||
<span style="color: #0000BB"><?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?></span> | <span style="color: #0000BB"><?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?></span> | ||
</span> | </span> | ||
</code> | </code> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== ملاحظات == | == ملاحظات == | ||
ملحوظة: عند استخدام المعامل | ملحوظة: عند استخدام المعامل <code>return</code>، تَستخدِمُ الدالةُ <code>highlight_string()</code> التخزينَ المؤقت للإخراج الداخلي بحيث لا يمكن استخدامها داخل دالة رد النداء <code>[[PHP/ob start|ob_start()]]</code>. | ||
ترميز HTML المُنْشَأُ عُرضةٌ للتغيير. | ترميز [[HTML]] المُنْشَأُ عُرضةٌ للتغيير. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة highlight_file(): تلوين شيفرات PHP في مَلفّ. | * الدالة <code>[[PHP/highlight file|highlight_file()]]</code>: تلوين شيفرات PHP في مَلفّ. | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.highlight-string.php صفحة الدالة highlight_string في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.highlight-string.php صفحة الدالة highlight_string في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP Miscellaneous]] | |||
المراجعة الحالية بتاريخ 14:09، 29 مايو 2018
(PHP 4, PHP 5, PHP 7)
تلوّن الدالةُ highlight_string() شيفرات PHP في سلسلة نصية.
الوصف
mixed highlight_string ( string $str [, bool $return = FALSE ] )
تطبع أو تعيد الدالةُ highlight_string() ترميزَ html لإصدارٍ ملونٍ من شيفرات PHP المعطاة باستخدام الألوان المُعرَّفة في ملوِّن الشيفرات المدمج في PHP.
المعاملات
str
شيفرة PHP المراد تلوينها. يجب أن تتضمن هذه الشيفرة وسمَ الفتح.
return
ضبط المعامل return إلى القيمة TRUE سيؤدي إلى إعادة الدالة highlight_string() للشيفرة الملوّنة بدل طباعتها مباشرةً.
القيم المعادة
إذا ضُبِطَ المعامل return إلى القيمة TRUE، فستُعاد الشيفرة الملونة كسلسلة نصية بدلًا من طباعتها. وإلا، فستُعاد القيمة TRUE عند النجاح، والقيمة FALSE عند الفشل.
أمثلة
المثال 1: مثال على الدالة highlight_string()
<?php
highlight_string('<?php phpinfo(); ?>');
?>
ناتج المثال السابق:
<code><span style="color: #000000">
<span style="color: #0000BB"><?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?></span>
</span>
</code>
ملاحظات
ملحوظة: عند استخدام المعامل return، تَستخدِمُ الدالةُ highlight_string() التخزينَ المؤقت للإخراج الداخلي بحيث لا يمكن استخدامها داخل دالة رد النداء ob_start().
ترميز HTML المُنْشَأُ عُرضةٌ للتغيير.
انظر أيضًا
- الدالة
highlight_file(): تلوين شيفرات PHP في مَلفّ.