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

من موسوعة حسوب
ط نقل جميل-بيلوني صفحة Kotlin/Comparable/index إلى Kotlin/Comparable: هو وجود الكلمة "index" في نهاية الرابط وهذا يخالف ما هو معتمد في بقية صفحات الموسوعة.
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Comparable</code>‎ في Kotlin}}</noinclude>
الأصناف التي ترث من الواجهة <code>Comparable</code> تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها.<syntaxhighlight lang="kotlin">
interface Comparable<in T>
</syntaxhighlight><noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Comparable</code>‎ في Kotlin}}</noinclude>


== الدوال ==
== الدوال ==
[[Kotlin/Comparable/compareTo|compareTo]]
[[Kotlin/Comparable/compareTo|<code>compareTo</code>]]


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


==الدوال الموروثة==
==الدوال الموروثة==
===<code>[[Kotlin/Any/equals|equals]]</code>===
===<code>[[Kotlin/Any/equals|equals]]</code>===
تبين الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
تحدد الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها.
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
يعيد التابع <code>hashCode()</code>‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
تعيد الدالة <code>hashCode()</code>‎ قيمة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.
===<code>[[Kotlin/Any/toString|toString]]</code>===
===<code>[[Kotlin/Any/toString|toString]]</code>===
يعيد التابع <code>toString()‎</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
تحول الدالة <code>toString()‎</code> الكائن الذي يُستدعى معها إلى سلسلة نصية.
 
== الدوال الإضافية (Extension Functions) ==
 
=== <code>[[Kotlin/ranges/coerceAtLeast|coerceAtLeast]]</code> ===
 
=== <code>[[Kotlin/ranges/coerceAtMost|coerceAtMost]]</code> ===
 
=== <code>[[Kotlin/ranges/coerceIn|coerceIn]]</code> ===
 
=== <code>[[Kotlin/ranges/rangeTo|rangeTo]]</code> ===


== الوارثات (Inheritors) ==
== الوارثات (Inheritors) ==


===<code>[[Kotlin/Boolean/index|Boolean]]</code>===
===<code>[[Kotlin/Boolean|Boolean]]</code>===
يمثل النوع <code>boolean</code> قيمة منطقية تساوي إما <code>true</code> أو <code>false</code>، في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثل كقيم للنوع <code>boolean</code>.
يمثل النوع <code>boolean</code> قيمة منطقية تساوي إما <code>true</code> أو <code>false</code>، في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثل كقيم للنوع <code>boolean</code>.


===<code>[[Kotlin/Byte/index|Byte]]</code>===
===<code>[[Kotlin/Byte|Byte]]</code>===
الصنف <code>‎‎Byte</code>في Kotlin
يمثل الصنف <code>Byte</code> عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع <code>byte</code> الأساسي.


===<code>[[Kotlin/Char/index|Char]]</code>===
===<code>[[Kotlin/Char|Char]]</code>===
الصنف <code>‎‎Char</code>في Kotlin
يمثل الصنف <code>Char</code> محرفًا بحجم 16 بت مرمزًا بالترميز الموحَّد (Unicode). في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع <code>char</code> الأساسي.


===<code>[[Kotlin/Double/index|Double]]</code>===
===<code>[[Kotlin/Double|Double]]</code>===
الصنف <code>‎‎Double</code>في Kotlin
الصنف <code>‎‎Double</code>في Kotlin


سطر 33: سطر 45:
===<code>[[Kotlin/Float/index|Float]]</code>===
===<code>[[Kotlin/Float/index|Float]]</code>===
الصنف <code>‎‎Float</code>في Kotlin
الصنف <code>‎‎Float</code>في Kotlin
=== <code>[[Kotlin/Int|Int]]</code> ===
=== <code>[[Kotlin/KotlinVersion|KotlinVersion]]</code> ===
=== <code>[[Kotlin/Long|Long]]</code> ===
=== <code>[[Kotlin/Short|Short]]</code> ===
=== <code>[[Kotlin/String|String]]</code> ===
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-comparable/index.html صفحة الصنف Comparable في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Classes]]
[[تصنيف:Kotlin Class]]
[[تصنيف:Kotlin Comparable]]
[[تصنيف:Kotlin Comparable]]

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

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها.

interface Comparable<in T>

الدوال

compareTo

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

الدوال الموروثة

equals

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

hashCode

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

toString

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

الدوال الإضافية (Extension Functions)

coerceAtLeast

coerceAtMost

coerceIn

rangeTo

الوارثات (Inheritors)

Boolean

يمثل النوع boolean قيمة منطقية تساوي إما true أو false، في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثل كقيم للنوع boolean.

Byte

يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي.

Char

يمثل الصنف Char محرفًا بحجم 16 بت مرمزًا بالترميز الموحَّد (Unicode). في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع char الأساسي.

Double

الصنف ‎‎Doubleفي Kotlin

Enum

الصنف ‎‎Enumفي Kotlin

Float

الصنف ‎‎Floatفي Kotlin

Int

KotlinVersion

Long

Short

String

مصادر