عرض مصدر PHP/is a

<noinclude>{{DISPLAYTITLE:الدالة <code>is_a()</code>‎ في PHP}}</noinclude>
(PHP 4 >= 4.2.0, PHP 5, PHP 7)

تتحقق الدالة <code>is_a()</code>‎‎‎‎‎‎ فيما إذا كان الكائن من صنفٍ معيّن أو كان ذاك الصنف واحدًا من الأصناف الآباء له.

== الوصف ==
<syntaxhighlight lang="php">
bool is_a(object $object string $class_name [,bool $allow_string = FALSE ])
</syntaxhighlight>تتحقق الدالة <code>is_a()</code>‎‎‎‎‎‎  فيما إذا كانت الكائن المُعطى  <code>object</code> هو من الصنف <code>class_name</code> أو يملك هذا الصنف كواحد من الأصناف الآباء له.

== المعاملات ==

=== <code>object</code> ===
الكائن المُختبر.

=== <code>class_name</code> ===
اسم الصنف.

=== <code>allow_string</code> ===
إذا ضُبِطَت قيمة هذا المعامل إلى القيمة FALSE، فلا يُسمح عندها باستخدام اسم صنف على شكل سلسلة نصية كقيمة للمعامل object. يمنع هذا أيضًا استدعاء autoloader إذا لم يكن الصنف موجودًا.

== القيم المعادة ==
تُعيد الدالة <code>is_a()</code>‎‎‎‎‎‎ القيمة <code>TRUE</code> إذا كان الكائن من صنفٍ معيّن أو يملك ذاك الصنف كواحد من الأصناف الآباء له، وإلا فإنها ستُعيد القيمة <code>FALSE</code> .

== سجل التغييرات ==
{| class="wikitable"
|الإصدار
|الوصف
|-
|5.3.9
|أُضيف المعامل <code>allow_string</code>.
|-
|5.3.0
|لم تعد هذه الدالة مُهملة ولم تعد ترمي التحذيرات <code>E_STRICT</code>.
|-
|5.0.0
|أصبحت هذه الدالة مُهملة لصالح العامل <code>instanceof</code>. حيث سينتج استدعاء هذه الدالة التحذير <code>E_STRICT</code>.
|}

== أمثلة ==
المثال 1: مثال عن استخدام الدالة is_a()‎‎‎‎<syntaxhighlight lang="php">
<?php
// تعريف صنف‏
class WidgetFactory
{
  var $oink = 'moo';
}

// إنشاء كائن جديد‏
$WF = new WidgetFactory();

if (is_a($WF, 'WidgetFactory')) {
  echo "yes, \$WF is still a WidgetFactory\n";
}
?>
</syntaxhighlight>المثال 2: مثال عن استخدام العامل <code>instanceof</code> في الإصدار PHP 5 <syntaxhighlight lang="php">
<?php
if ($WF instanceof WidgetFactory) {
    echo 'Yes, $WF is a WidgetFactory';
}
?>
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>get_class()</code>‎‎‎‎: إعادة اسم الصنف لكائن.
* الدالة <code>[[PHP/get parent class|get_parent_class()]]‎‎‎‎‎‎</code>: الحصول على اسم الصنف الأب لكائن أو لصنف.
* الدالة <code>is_subclass_of()‎‎‎‎</code>: التحقق فيما إذا كان يملك الكائن صنفًا ما كواحد من الأصناف الآباء له.

== مصادر ==
* [http://php.net/manual/en/function.is-a.php صفحة الدالة is_a()‎‎‎ في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP OOP]]
[[تصنيف:PHP Object Handling]]