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