الفرق بين المراجعتين ل"PHP/function exists"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
| سطر 1: | سطر 1: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
| − | تُعيد الدالة function_exists() القيمة TRUE إذا كانت الدالّة المُعطاة مُعرّفة. | + | تُعيد الدالة <code>function_exists()</code> القيمة <code>TRUE</code> إذا كانت الدالّة المُعطاة مُعرّفة. |
== الوصف == | == الوصف == | ||
----<syntaxhighlight lang="php"> | ----<syntaxhighlight lang="php"> | ||
bool function_exists ( string $function_name ) | bool function_exists ( string $function_name ) | ||
| − | </syntaxhighlight>تتحقق الدالّة function_exists() من وجود الدالة function_name في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. | + | </syntaxhighlight>تتحقق الدالّة <code>function_exists()</code> من وجود الدالة <code>function_name</code> في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. |
== المعاملات == | == المعاملات == | ||
---- | ---- | ||
| − | === function_name === | + | === <code>function_name</code> === |
سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا. | سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا. | ||
== القيم المعادة == | == القيم المعادة == | ||
| − | ----تُعيد الدالة function_exists() القيمة TRUE إذا كانت الدالّة function_name موجودةً، وتُعيد القيمة | + | ----تُعيد الدالة <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>. | ||
== أمثلة == | == أمثلة == | ||
| − | ----المثال 1: مثال عن استخدام الدالة function_exists() <syntaxhighlight lang="php"> | + | ----المثال 1: مثال عن استخدام الدالة <code>function_exists()</code> <syntaxhighlight lang="php"> |
<?php | <?php | ||
if (function_exists('imap_open')) { | if (function_exists('imap_open')) { | ||
| سطر 36: | سطر 34: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
---- | ---- | ||
| − | * الدالة method_exists(): التحقق من وجود الدالة التابعة للصنف. | + | * الدالة <code>[[PHP/method exists|method_exists()]]</code>: التحقق من وجود الدالة التابعة للصنف. |
| − | * الدالة is_callable(): التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة. | + | * الدالة <code>[[PHP/is callable|is_callable()]]</code>: التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة. |
| − | * [[PHP/get defined functions| | + | * الدالة <code>[[PHP/get defined functions|get_defined_functions()]]</code>: إعادة مصفوفة تحتوي على كل الدوال المعرّفة. |
| − | * الدالة class_exists(): التحقق إذا كان صنفٌ ما معرَّفًا. | + | * الدالة <code>[[PHP/class exists|class_exists()]]</code>: التحقق إذا كان صنفٌ ما معرَّفًا. |
| − | * | + | * الدالة<code>[[PHP/extension loaded|extension_loaded()]]</code> : معرفة فيما إذا حُمِّل أحد الامتدادات. |
== مصادر == | == مصادر == | ||
| − | ----[http://php.net/manual/en/function.function-exists.php | + | ---- |
| + | * [http://php.net/manual/en/function.function-exists.php صفحة الدالة ()function_exists في توثيق PHP الرسمي.] | ||
مراجعة 13:08، 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(): معرفة فيما إذا حُمِّل أحد الامتدادات.