عرض مصدر Python/isinstance

<noinclude>{{DISPLAYTITLE:الدالة <code>isinstance()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>isinstance()‎</code> قيمة منطقيّةً تُشير إلى ما إذا كان الكائن المُعطى نسخة (instance) من الصّنف المُعطى أو لا.

== البنية العامة ==
<syntaxhighlight lang="python3">
isinstance(object, classinfo)
</syntaxhighlight>

== المعاملات ==
=== <code>object</code> ===
الكائن المرغوب التّحقّق من كونه نسخةً من الصّنف (أو النّوع) المُعطى.

=== <code>classinfo</code> ===
الصّنف أو النّوع المرغوب التّحقق من أنّ الكائن نسخة منه.
يُمكن كذلك أن يقبل [[Python/tuples|صفًّا]] (أو عدّة صفوف) من الأصناف أو الأنواع للتحقّق من أنّ الكائن نُسخة من أحدها.

== القيمة المعادة ==
* القيمة <code>True</code> إن كان الكائن نُسخة من الصّنف أو نسخة من أحد الأصناف الفرعيّة (سواء كان مُباشرًا، غير مباشر، أو وهميًّا). والقيمة <code>False</code> إن لم يكن كذلك. 

== الاستثناءات ==
* يُطلق استثناء TypeError إن لم تكن قيمة المُعامل <code>classinfo</code> نوعًا أو صفّ أنواعٍ أو عدّة صفوف من هذه الصّفوف.


== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> isinstance(1, int) # عدد صحيح نسخة من نوع الأعداد الصّحيحة
True
>>> isinstance(1.0, int) # العدد ليس صحيحًا بل عشري
False
>>> isinstance(1.0, (int, float))
True

>>> class A: # صنف
...     pass
... 
>>> class B(A): # صنف وارث
...     pass
... 
>>> a = B() # كائن من الصّنف الوارث
>>> isinstance(a, B) # الكائن نسخة من صنفه
True
>>> isinstance(a, A) # الكائن نسخة من الصّنف الأب لصنفه
True
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/TypeError|TypeError]].
* [[Python/class-definition|تعريف الأصناف في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/functions.html#isinstance قسم الدالة isinstance في صفحة Functions في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]