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

مراجعة 16:44، 24 يونيو 2018

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

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

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

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

قيمة عددية.

أمثلة

استخدام الدالة `()compareTo`

تعرّف الشيفرة الآتية سلسلتين نصيتين باسم x و y ، ثم تستخدم الدالة()compareTo على x وتمرر y كوسيط للمقارنة بينهما، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val x = "hsoub"
    val y = "academy"
    
    println(x.compareTo(y) )// 7
}

أنظر أيضًا

or()‎ : تقوم بالعملية المنطقة or بين قيمتين منطقيتين، وعلى خلاف المعامل ||، فهذه الدالة تتحقق من كلا القيمتين المنطقيتين.
not()‎ : تعيد نفي القيمة المنطقية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>compareTo()‎</code> في لغة Kotlin}}</noinclude>
-تقوم الدالة<code>compareTo()‎</code> بالعملية المنطقة <code>and</code> بين قيمتين منطقيتين، وعلى خلاف المعامل <code>&&،</code> فهذه الدالة تتحقق من كلا القيمتين المنطقيتين<nowiki/><nowiki/>.
+تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <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>()compareTo</code>===
+تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/String|سلسلتين نصيتين]] باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()compareTo</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:
 <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/not|not()]]</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]]