الفرق بين المراجعتين لصفحة: «Kotlin/DeprecationLevel»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>DeprecationLevel</code> في Kotlin}}</noinclude> | يحوي الصنف <code>DeprecationLevel</code> مستويات تصف درجات الإهمال (deprecation levels).<syntaxhighlight lang="kotlin"> | ||
enum class DeprecationLevel | |||
</syntaxhighlight> | |||
== القيم القابلة للعد (Enum Values) == | |||
[[Kotlin/DeprecationLevel/WARNING|<code>WARNING</code>]] | |||
تشير القيمة <code>WARNING</code> إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element).<noinclude>{{DISPLAYTITLE:الصنف <code>DeprecationLevel</code> في Kotlin}}</noinclude> | |||
=== <code>[[Kotlin/DeprecationLevel/ERROR|ERROR]]</code> === | === <code>[[Kotlin/DeprecationLevel/ERROR|ERROR]]</code> === | ||
تشير القيمة <code>ERROR</code> إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). | |||
=== <code>[[Kotlin/DeprecationLevel/HIDDEN|HIDDEN]]</code> === | === <code>[[Kotlin/DeprecationLevel/HIDDEN|HIDDEN]]</code> === | ||
تشير القيمة <code>HIDDEN</code> إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. | |||
== الخاصيات الموروثة (Inherited Properties) == | |||
=== <code>[[Kotlin/Enum/name|name]]</code> === | === <code>[[Kotlin/Enum/name|name]]</code> === | ||
تمثِّل الخاصية <code>Enum.name</code> اسم الثابت المعرف في الكائن <code>[[Kotlin/Enum|enum]]</code> الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. | |||
=== <code>[[Kotlin/Enum/ordinal|ordinal]]</code> === | === <code>[[Kotlin/Enum/ordinal|ordinal]]</code> === | ||
=== <code>[[Kotlin/Enum/clone|clone]]</code> | تمثل الخاصية <code>Enum.ordinal</code> ترتيب (ordinal) الثابت المعرف في الكائن <code>[[Kotlin/Enum|enum]]</code> الذي استُدعي معها؛ أي موقعه في تصريح الكائن <nowiki/>[[Kotlin/Enum|<code>enum</code>]]، إذ يكون موقع الثابت الأول هو 0 وهكذا. | ||
== الدوال الموروثة (Inherited Functions) == | |||
<code>[[Kotlin/Enum/clone|clone]]</code> | |||
يرمي التابع <code>clone()</code> استثناءً لأنّ ثوابت الصنف <nowiki/>[[Kotlin/Enum|<code>Enum</code>]] لا يمكن أن تُنسخ. تمنع هذه الدالة الأصناف ذات النوع <code>[[Kotlin/Enum|Enum]]</code> من أن ترِث من الصنف <code>Cloneable</code>. | |||
=== <code>[[Kotlin/Enum/compareTo|compareTo]]</code> === | === <code>[[Kotlin/Enum/compareTo|compareTo]]</code> === | ||
=== <code>[[Kotlin/Enum/equals|equals]]</code> === | توازن الدالة <code>compareTo()</code> بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني. | ||
=== <code>[[Kotlin/Enum/hashCode|hashCode]]</code> === | |||
=== <code>[[Kotlin/Enum/toString|toString]]</code> === | ===<code>[[Kotlin/Enum/equals|equals]]</code>=== | ||
تتحقق الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. | |||
===<code>[[Kotlin/Enum/hashCode|hashCode]]</code>=== | |||
تعيد الدالة <code>hashCode()</code> الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. | |||
===<code>[[Kotlin/Enum/toString|toString]]</code>=== | |||
تحول الدالة <code>toString()</code> الكائن الذي استُدعي معها إلى سلسلة نصية (String). | |||
== مصادر == | |||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-deprecation-level/index.html صفحة الصنف DeprecationLevel في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | |||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Class]] | ||
[[تصنيف:Kotlin DeprecationLevel]] | [[تصنيف:Kotlin DeprecationLevel]] | ||
المراجعة الحالية بتاريخ 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).