الفرق بين المراجعتين لصفحة: «PHP/function exists»
< PHP
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>function_exists()</code> في PHP}}</noinclude> | |||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
| سطر 4: | سطر 5: | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | |||
bool function_exists ( string $function_name ) | bool function_exists ( string $function_name ) | ||
</syntaxhighlight>تتحقق الدالّة <code>function_exists()</code> من وجود الدالة <code>function_name</code> في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. | </syntaxhighlight>تتحقق الدالّة <code>function_exists()</code> من وجود الدالة <code>function_name</code> في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. | ||
== المعاملات == | == المعاملات == | ||
=== <code>function_name</code> === | === <code>function_name</code> === | ||
سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا. | سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا. | ||
== القيم المعادة == | == القيم المعادة == | ||
تُعيد الدالة <code>function_exists()</code> القيمة <code>TRUE</code> إذا كانت الدالّة <code>function_name</code> موجودةً، وتُعيد القيمة <code>FALSE</code> في ما عدا ذلك. | |||
ملاحظة: ستُعيد الدالة <code>function_exists()</code> القيمة <code>FALSE</code> من أجل البنى الموجودة في لغة PHP مثل <code>[[PHP/include once|include_once]]</code> و <code>[[PHP/echo|echo]]</code>. | ملاحظة: ستُعيد الدالة <code>function_exists()</code> القيمة <code>FALSE</code> من أجل البنى الموجودة في لغة PHP مثل <code>[[PHP/include once|include_once]]</code> و <code>[[PHP/echo|echo]]</code>. | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال عن استخدام الدالة <code>function_exists()</code> <syntaxhighlight lang="php"> | |||
<?php | <?php | ||
if (function_exists('imap_open')) { | if (function_exists('imap_open')) { | ||
| سطر 30: | سطر 29: | ||
== ملاحظات == | == ملاحظات == | ||
قد يكون اسم الدالة موجودًا حتى ولو كانت الدالة نفسها غير قابلة للاستخدام بسبب خيارات الضبط وبناء لغة PHP (مثل دوال التعامل مع الصور). | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[PHP/method exists|method_exists()]]</code>: التحقق من وجود الدالة التابعة للصنف. | * الدالة <code>[[PHP/method exists|method_exists()]]</code>: التحقق من وجود الدالة التابعة للصنف. | ||
* الدالة <code>[[PHP/is callable|is_callable()]]</code>: التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة. | * الدالة <code>[[PHP/is callable|is_callable()]]</code>: التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة. | ||
| سطر 41: | سطر 39: | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.function-exists.php صفحة الدالة ()function_exists في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.function-exists.php صفحة الدالة ()function_exists في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP Function Handling]] | |||
مراجعة 13:11، 15 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تُعيد الدالة function_exists() القيمة TRUE إذا كانت الدالّة المُعطاة مُعرّفة.
الوصف
bool function_exists ( string $function_name )
تتحقق الدالّة function_exists() من وجود الدالة function_name في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم.
المعاملات
function_name
سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا.
القيم المعادة
تُعيد الدالة function_exists() القيمة TRUE إذا كانت الدالّة function_name موجودةً، وتُعيد القيمة FALSE في ما عدا ذلك.
ملاحظة: ستُعيد الدالة function_exists() القيمة FALSE من أجل البنى الموجودة في لغة PHP مثل include_once و echo.
أمثلة
المثال 1: مثال عن استخدام الدالة function_exists()
<?php
if (function_exists('imap_open')) {
echo "IMAP functions are available.<br />\n";
} else {
echo "IMAP functions are not available.<br />\n";
}
?>
ملاحظات
قد يكون اسم الدالة موجودًا حتى ولو كانت الدالة نفسها غير قابلة للاستخدام بسبب خيارات الضبط وبناء لغة PHP (مثل دوال التعامل مع الصور).
انظر أيضًا
- الدالة
method_exists(): التحقق من وجود الدالة التابعة للصنف. - الدالة
is_callable(): التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة. - الدالة
get_defined_functions(): إعادة مصفوفة تحتوي على كل الدوال المعرّفة. - الدالة
class_exists(): التحقق إذا كان صنفٌ ما معرَّفًا. - الدالة
extension_loaded(): معرفة فيما إذا حُمِّل أحد الامتدادات.