PHP/function exists

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

مصادر

---

●   صفحة الدالة ()function_exists في توثيق PHP الرسمي.