عرض مصدر Kotlin/equality

<noinclude>{{DISPLAYTITLE:التساوي (Equality) في لغة Kotlin}}</noinclude>
تحتوي لغة Kotlin على نوعين من التساوي:
* '''التساوي البنيويّ (structural equality):''' يكون التحقُّق فيه عبر الدالة <code>equals()</code>‎.
* '''التساوي المرجعيّ (referential equality):''' وهو التحقُّق من الإشارة إلى نفس الكائن (object).

== التساوي البنيويّ (Structural Equality) ==
يعتمد التساوي البنيويّ على المعامل <code>==</code> ونفيه <code>=!</code> ، إذ يُترجَم التعبير  <code>a == b</code> إلى الصيغة:<syntaxhighlight lang="kotlin">
a?.equals(b) ?: (b === null)
</syntaxhighlight>فإن لم يحتوِ المتغيِّر <code>a</code> على القيمة الفارغة <code>null</code> فستُستدعَى الدالة<code>equals(Any?)‎</code> ، أما إن كانت قيمته <code>null</code> فيجري التحقُّق من أنّ <code>b</code> مساوٍ -مرجعيًّا- للقيمة <code>null</code>.

ولا حاجة للمقارنة الصريحة الصارمة (explicit) مع القيمة <code>null</code> في الشيفرة لأنّ التعبير <code>a == null</code> سيُترجَم تلقائيًا إلى الصيغة <code>a === null</code>.

== تساوي أعداد الفاصلة العائمة ==
تخضع عملية المقارنة للمعايير القياسيّة IEEE 754 للعمليات الحسابيّة على أعداد الفاصلة العائمة إن كان المعاملان (operands) على طرفيّ المساواة مُعرَّفان ستاتيكيًّا من النوع <code>Float</code> أو <code>Double</code> (سواءً أكانت القيمة <code>null</code> أم لا).

ويُستخدَم التساوي البنيويّ (structural equality) في الحالات الأخرى، والذي لا يوافق المعايير القياسيّة فلذلك تكون القيمة <code>NaN</code> مساويةً لنفسها وتختلف القيمتان <code>0.0-</code> و <code>0.0</code> عن بعضهما.

راجع [[Kotlin/basic types|مقارنة أعداد الفاصلة العائمة]].

== التساوي المرجعيّ (Referential Equality) ==
يعتمد على المعامل <code>===</code> ونفيه <code>==!</code> حيث ستنتُج القيمة <code>true</code> عن الشرط <code>a === b</code>  فقط وفقط إذا كان كلا المتغيِّرين <code>a</code> و <code>b</code> يشيران لنفس الكائن (object)، أمّا عندما تكون القيم مُمثَّلةً بأنواعٍ أساسيّةٍ (primitive types) أثناء التنفيذ (مثل النوع <code>Int</code>) فيكون المعامل <code>===</code> حينئذٍ مكافئًا للمعامل <code>==</code>.

== مصادر ==
* [https://kotlinlang.org/docs/reference/equality.html صفحة التساوي في التوثيق الرسميّ للغة Kotlin]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Types]]
[[تصنيف:Kotlin Operators]]