الفرق بين المراجعتين ل"Kotlin/Enum"
| سطر 1: | سطر 1: | ||
| + | == الدوال البانية == | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>Enum</code> في Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE:الصنف <code>Enum</code> في Kotlin}}</noinclude> | ||
=== <code>[[Kotlin/Enum/Init|<init>]]</code> === | === <code>[[Kotlin/Enum/Init|<init>]]</code> === | ||
| + | <code>[[Kotlin/Enum/index|Enum]]</code> هو الصنف الأساس لكل أصناف الترقيم (enum classes)، | ||
| + | |||
| + | == الخاصيات == | ||
| + | |||
=== <code>[[Kotlin/Enum/name|name]]</code> === | === <code>[[Kotlin/Enum/name|name]]</code> === | ||
| + | تعيد الخاصية <code>name</code> اسم الثابت من الكائن <code>enum</code> الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. | ||
| + | |||
=== <code>[[Kotlin/Enum/ordinal|ordinal]]</code> === | === <code>[[Kotlin/Enum/ordinal|ordinal]]</code> === | ||
| + | تعيد الخاصية <code>ordinal</code> ترتيب الثابت من الكائن <code>enum</code> الذي استُدعيت عبره enumeration constant))، أي ترتيبها في تصريح الكائن <code>enum،</code>بحيث تأخذ المُركّبة الأولى العدد <code>0</code>. | ||
| + | |||
| + | == الدوال == | ||
| + | |||
=== <code>[[Kotlin/Enum/clone|clone]]</code> === | === <code>[[Kotlin/Enum/clone|clone]]</code> === | ||
| + | يطلق التابع <code>clone()</code> استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع <code>[[Kotlin/Enum/index|Enum]]</code> من أن ترِث من الصنف<code>Cloneable</code>. | ||
| + | |||
=== <code>[[Kotlin/Enum/compareTo|compareTo]]</code> === | === <code>[[Kotlin/Enum/compareTo|compareTo]]</code> === | ||
| + | تقارن الدالة<code>compareTo()</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . | ||
| + | |||
=== <code>[[Kotlin/Enum/equals|equals]]</code> === | === <code>[[Kotlin/Enum/equals|equals]]</code> === | ||
| + | تبين الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. | ||
| + | |||
| + | |||
=== <code>[[Kotlin/Enum/hashCode|hashCode]]</code> === | === <code>[[Kotlin/Enum/hashCode|hashCode]]</code> === | ||
| + | يعيد التابع <code>hashCode()</code> قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. | ||
| + | |||
| + | |||
=== <code>[[Kotlin/Enum/toString|toString]]</code> === | === <code>[[Kotlin/Enum/toString|toString]]</code> === | ||
| − | + | يعيد التابع <code>toString()</code> تمثيلا نصيا للكائن الذي استُدعيت عبره. | |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Classes]] | [[تصنيف:Kotlin Classes]] | ||
[[تصنيف:Kotlin Enum]] | [[تصنيف:Kotlin Enum]] | ||
مراجعة 12:00، 17 يوليو 2018
الدوال البانية
<init>
Enum هو الصنف الأساس لكل أصناف الترقيم (enum classes)،
الخاصيات
name
تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن.
ordinal
تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره enumeration constant))، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0.
الدوال
clone
يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable.
compareTo
تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
equals
تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
hashCode
يعيد التابع hashCode() قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
toString
يعيد التابع toString() تمثيلا نصيا للكائن الذي استُدعيت عبره.