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

المراجعة الحالية بتاريخ 12:16، 8 سبتمبر 2018

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

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

fun compareTo(other: Boolean): Int (source)

المعاملات

`other`

القيمة المنطقية الأخرى التي ستطبق عليها العملية.

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

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

أمثلة

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

fun main(args: Array<String>) {
    val x = "hsoub"
    val y = "academy"

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

انظر أيضًا

الدالة and()‎: تجري العملية and المنطقية بين قيمتين منطقيتين.
الدالة or()‎ : تجري العملية or المنطقية بين قيمتين منطقيتين.
الدالة not()‎: تعكس القيمة المنطقيَّة المستدعاة معها.
الدالة xor()‎: تجري العملية xor المنطقية بين قيمتين منطقيتين.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>compareTo()‎</code> في Kotlin}}</noinclude>
-تقوم الدالة<code>compareTo()‎</code> بالعملية المنطقة <code>and</code> بين قيمتين منطقيتين، وعلى خلاف المعامل <code>&&،</code> فهذه الدالة تتحقق من كلا القيمتين المنطقيتين<nowiki/><nowiki/>.
+توازن الدالة <code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية<nowiki/><nowiki/>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-infix fun and(other: Boolean): Boolean
+fun compareTo(other: Boolean): Int (source)
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>infix</code> للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل <code>.</code>والأقواس <code>()</code> المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/functions#.D8.A7.D9.84.D8.AA.D8.AF.D9.88.D9.8A.D9.86 .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D9.91 .28Infix notation.29|توثيق التدوين الداخلي للدوال (infix functions)]].
+</syntaxhighlight>
-==القيمة المُعادة==
-قيمة منطقية.
+== المعاملات ==
+=== <code>other</code> ===
+القيمة المنطقية الأخرى التي ستطبق عليها العملية.
+==القيمة المعادة==
+تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع القيمة <code>other</code>، أو  تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة الوسيط <code>other</code>)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==أمثلة==
-===استخدام الدالة <code>()compareTo</code>===
+<nowiki/>استعمال الدالة <code>()compareTo</code> للموازنة بين سلسلتين نصيتين:<syntaxhighlight lang="kotlin">
-<nowiki/><nowiki/><nowiki/><syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     println(true and false) // false
+     val x = "hsoub"
-     println(true and true) // true
+     val y = "academy"
-     println(false and false) // false
+     println(x.compareTo(y)) // 7
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-*<code>[[Kotlin/Boolean/or|or()]]</code>‎ : تقوم بالعملية المنطقة <code>or</code> بين قيمتين منطقيتين، وعلى خلاف المعامل <code>||،</code> فهذه الدالة تتحقق من كلا القيمتين المنطقيتين.
+*الدالة <code>[[Kotlin/Boolean/and|and()‎]]</code>: تجري العملية <code>and</code> المنطقية بين قيمتين منطقيتين.
+*الدالة <code>[[Kotlin/Boolean/or|or()]]</code>‎ : تجري العملية <code>or</code> المنطقية بين قيمتين منطقيتين.
+*الدالة <code>[[Kotlin/Boolean/not|not()‎]]</code>: تعكس القيمة المنطقيَّة المستدعاة معها.
+*الدالة <code>[[Kotlin/Boolean/xor|xor()‎]]</code>: تجري العملية <code>xor</code> المنطقية بين قيمتين منطقيتين.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/or.html الدالة  compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/compare-to.html صفحة الدالة compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Boolean]]