الفرق بين المراجعتين لصفحة: «PHP/function exists»

من موسوعة حسوب
< PHP
 
(2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>function_exists()</code>‎ في PHP}}</noinclude>
(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> في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم.


== المعاملات ==
== المعاملات ==
----
=== <code>function_name</code> ===
 
=== function_name ===
سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا.
سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا.


== القيم المعادة ==
== القيم المعادة ==
----تُعيد الدالة function_exists()‎ القيمة TRUE إذا كانت الدالّة function_name موجودةً، وتُعيد القيمة FAlSE في ما عدا ذلك.
تُعيد الدالة <code>function_exists()‎</code> القيمة <code>TRUE</code> إذا كانت الدالّة <code>function_name</code> موجودةً، وتُعيد القيمة <code>FALSE</code> في ما عدا ذلك.
{| class="wikitable"
|ملاحظة: ستُعيد الدالة function_exists()‎ القيمة FALSE من أجل البنى الموجودة في لغة PHP مثل include_once و echo.
|}


ملاحظة: ستُعيد الدالة <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')) {
سطر 32: سطر 29:


== ملاحظات ==
== ملاحظات ==
----قد يكون اسم الدالة موجودًا حتى ولو كانت الدالة نفسها غير قابلة للاستخدام بسبب خيارات الضبط وبناء لغة PHP (مثل دوال التعامل مع الصور).
قد يكون اسم الدالة موجودًا حتى ولو كانت الدالة نفسها غير قابلة للاستخدام بسبب خيارات الضبط وبناء لغة PHP (مثل دوال التعامل مع الصور).


== انظر أيضًا ==
== انظر أيضًا ==
----
* الدالة <code>[[PHP/method exists|method_exists()‎]]</code>: التحقق من وجود الدالة التابعة للصنف.
* الدالة method_exists()‎: التحقق من وجود الدالة التابعة للصنف.
* الدالة <code>[[PHP/is callable|is_callable()‎]]</code>: التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة.
* الدالة is_callable()‎: التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة.
* الدالة <code>[[PHP/get defined functions|get_defined_functions()‎]]</code>: إعادة مصفوفة تحتوي على كل الدوال المعرّفة.
* [[PHP/get defined functions|الدالة get_defined_functions()‎: إعادة مصفوفة تحتوي على كل الدوال المعرّفة.]]
* الدالة <code>[[PHP/class exists|class_exists()‎]]</code>: التحقق إذا كان صنفٌ ما معرَّفًا.
* الدالة class_exists()‎: التحقق إذا كان صنفٌ ما معرَّفًا.
* الدالة<code>[[PHP/extension loaded|extension_loaded()]]</code> ‎: معرفة فيما إذا حُمِّل أحد الامتدادات.
* الدالةextension_loaded() ‎: معرفة فيما إذا حُمِّل أحد الامتدادات.


== مصادر ==
== مصادر ==
----[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:14، 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() ‎: معرفة فيما إذا حُمِّل أحد الامتدادات.

مصادر