الفرق بين المراجعتين لصفحة: «Kotlin/DeprecationLevel»

مراجعة 07:24، 9 سبتمبر 2018

يحوي الصنف 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()‎ بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني.

`equals`

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

`hashCode`

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

`toString`

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

مصادر

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

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