الفرق بين المراجعتين لصفحة: «Kotlin/Enum/equals»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع Enum.equals() في لغة Kotlin}}</noinclude> تبين الدالة <code>equals()</code> إذا ما كان الكائن...' |
لا ملخص تعديل |
||
سطر 9: | سطر 9: | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
fun equals(other: Any?): Boolean | |||
</syntaxhighlight> | |||
== القيم المعادة == | == القيم المعادة == | ||
القيمة المنطقية <code>true</code> إن كان الكائن المُمرّر للدالة يساوي الكائن الذي استدعيت عبره، أو <code>false</code> خلاف ذلك. | القيمة المنطقية <code>true</code> إن كان الكائن المُمرّر للدالة يساوي الكائن الذي استدعيت عبره، أو <code>false</code> خلاف ذلك. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* | * الخاصيّة <code>[[Kotlin/Enum/ordinal|ordinal]]</code>: تعيد ترتيب مُركّبة الكائن <code>enum</code> الذي استُدعيت عبره، أي ترتيبها في تصريح الكائن <code>enum،</code> بحيث تأخذ المُركّبة الأولى العدد <code>0</code>. | ||
* | * الخاصيّة <code>[[Kotlin/Enum/name|name]]</code>:تعيد اسم مُركّبة الكائن <code>enum</code> الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. | ||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/- | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/equals.html صفحة الدالة Enum.equals() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] |
مراجعة 19:00، 3 يوليو 2018
تبين الدالة equals()
إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون:
- انعكاسيًا (Reflexive): لكل مرجع
x
لا يساويnull
، يجب أن تُعيد العبارةx.equals(x)
القيمةtrue
. - تماثليًَا (Symmetric): لكل قيمتين مرجعيتين
x
وy
لا تساويانnull
، ستعيد العبارةx.equals (y)
القيمةtrue
إذا وفقط إذا أعادت العبارةy.equals (x)
القيمةtrue
. - تواتريًا (Transitive): لكل القيم المرجعية
x
وy
وz
التي لا تساويnull
، ستعيد العبارةx.equals (z)
القيمةtrue
إن كانت العبارتانx.equals (y)
وy.equals (z)
تعيدان القيمةtrue
أيضًا. - متسقًا (Consistent): لكل قيمتين مرجعيتين
x
وy
لا تساويانnull
، سيعيد استدعاء الدالةx.equals (y)
دائمًا إحدى القيمتينtrue
أوfalse
شريطة عدم تغيير أي معلومة تستخدمها الدالةequals()
لأجل مقارنة الكائنين.
تذكر أنَّ العامل ==
في أكواد Kotlin سيُترجم إلى استدعاءٍ للدالة equals()
عندما يكون كلا الكائنين المُقارَنَين مخالفين للقيمة null
.
البنية العامة
fun equals(other: Any?): Boolean
القيم المعادة
القيمة المنطقية true
إن كان الكائن المُمرّر للدالة يساوي الكائن الذي استدعيت عبره، أو false
خلاف ذلك.
انظر أيضًا
- الخاصيّة
ordinal
: تعيد ترتيب مُركّبة الكائنenum
الذي استُدعيت عبره، أي ترتيبها في تصريح الكائنenum،
بحيث تأخذ المُركّبة الأولى العدد0
. - الخاصيّة
name
:تعيد اسم مُركّبة الكائنenum
الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن.