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

المراجعة الحالية بتاريخ 04:06، 9 سبتمبر 2018

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

البنية العامة

fun compareTo(other: Char): Int

المعاملات

`other`

المحرف الآخر الذي يراد موازنته مع المحرف المعطى.

القيمة المعادة

تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع قيمة الوسيط other، أو تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة المعامل other)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.

أمثلة

استعمال الدالة ()compareTo للموازنة بين حرفين:

fun main(args: Array<String>) {
    val x = 'r'
    val y = 'f'

    println(x.compareTo(y)) // 1
}

انظر أيضًا

الدالة dec()‎: تعيد المحرف السابق للمحرف الذي استُدعيت معه.
الدالة inc()‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
الدالة minus()‎: تطرح القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع Int يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع Int، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه.
الدالة plus()‎: تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
الدالة rangeTo()‎: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.

مصادر

صفحة الدالة compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Char.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Char.compareTo()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+توازن الدالة <code>compareTo()‎</code> بين قيمة المحرف الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة المحرف الذي استُدعي معها) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun compareTo(other: Byte): Int
+fun compareTo(other: Char): Int
-operator fun compareTo(other: Short): Int
-operator fun compareTo(other: Int): Int
-operator fun compareTo(other: Long): Int
-operator fun compareTo(other: Float): Int
-operator fun compareTo(other: Double): Int
 </syntaxhighlight>
-==القيمة المُعادة==
-قيمة عددية.
+== المعاملات ==
+=== <code>other</code> ===
+المحرف الآخر الذي يراد موازنته مع المحرف المعطى.
+==القيمة المعادة==
+تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع قيمة الوسيط <code>other</code>، أو تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة المعامل <code>other</code>)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==أمثلة==
-===استخدام الدالة <code>()compareTo</code>===
+استعمال الدالة <code>()compareTo</code> للموازنة بين حرفين:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()compareTo</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
-fun main(args: Array<String>) {
+     val x = 'r'
-     val x = 5
+     val y = 'f'
-     val y = 4
+     println(x.compareTo(y)) // 1
-     println(x.compareTo(y) )// 1
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-*<code>[[Kotlin/Boolean/or|or()]]</code>‎ : تقوم بالعملية المنطقة <code>or</code> بين قيمتين منطقيتين، وعلى خلاف المعامل <code>||،</code> فهذه الدالة تتحقق من كلا القيمتين المنطقيتين.
+* الدالة <code>[[Kotlin/Char/dec|dec()‎]]</code>: تعيد المحرف السابق للمحرف الذي استُدعيت معه.
+* الدالة <code>[[Kotlin/Char/inc|inc()]]</code>‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
+* الدالة <code>[[Kotlin/Char/minus|minus()‎]]</code>: تطرح القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع <code>[[Kotlin/Int|Int]]</code> يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع [[Kotlin/Int|<code>Int</code>]]، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه.
+* الدالة <code>[[Kotlin/Char/plus|plus()‎]]</code>: تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
+* الدالة <code>[[Kotlin/Char/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/compare-to.html الدالة  compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char/compare-to.html صفحة الدالة compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Char]]