الفرق بين المراجعتين ل"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()
: معرفة فيما إذا حُمِّل أحد الامتدادات.