الصنف ‎‎DeprecationLevel‎ في Kotlin

يحوي الصنف DeprecationLevel مستويات تصف درجات الإهمال (deprecation levels).

enum class DeprecationLevel

القيم القابلة للعد (Enum Values)

WARNING

تشير القيمة 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

يرمي التابع clone()‎ استثناءً لأنّ ثوابت الصنف Enum لا يمكن أن تُنسخ. تمنع هذه الدالة الأصناف ذات النوع Enum من أن ترِث من الصنف Cloneable.

compareTo

توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني.

equals

تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها.

hashCode

تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.

toString

تحول الدالة toString()‎ الكائن الذي استُدعي معها إلى سلسلة نصية (String).

مصادر

• صفحة الصنف DeprecationLevel في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.