الفرق بين المراجعتين لصفحة: «Kotlin/DeprecationLevel»
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 31: | سطر 31: | ||
===<code>[[Kotlin/Enum/equals|equals]]</code>=== | ===<code>[[Kotlin/Enum/equals|equals]]</code>=== | ||
تتحقق الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. | تتحقق الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. | ||
===<code>[[Kotlin/Enum/hashCode|hashCode]]</code>=== | ===<code>[[Kotlin/Enum/hashCode|hashCode]]</code>=== | ||
تعيد الدالة <code>hashCode()</code> الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. | تعيد الدالة <code>hashCode()</code> الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. | ||
المراجعة الحالية بتاريخ 07:25، 9 سبتمبر 2018
يحوي الصنف DeprecationLevel مستويات تصف درجات الإهمال (deprecation levels).
enum class DeprecationLevel
القيم القابلة للعد (Enum Values)
تشير القيمة WARNING إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element).
ERROR
تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element).
HIDDEN
تشير القيمة HIDDEN إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة.
الخاصيات الموروثة (Inherited Properties)
name
تمثِّل الخاصية Enum.name اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن.
ordinal
تمثل الخاصية Enum.ordinal ترتيب (ordinal) الثابت المعرف في الكائن enum الذي استُدعي معها؛ أي موقعه في تصريح الكائن enum، إذ يكون موقع الثابت الأول هو 0 وهكذا.
الدوال الموروثة (Inherited Functions)
يرمي التابع clone() استثناءً لأنّ ثوابت الصنف Enum لا يمكن أن تُنسخ. تمنع هذه الدالة الأصناف ذات النوع Enum من أن ترِث من الصنف Cloneable.
compareTo
توازن الدالة compareTo() بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني.
equals
تتحقق الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها.
hashCode
تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.
toString
تحول الدالة toString() الكائن الذي استُدعي معها إلى سلسلة نصية (String).