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

مراجعة 04:59، 10 أغسطس 2018

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

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

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

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

تعاد القيمة 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>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+توازن الدالة <code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية<nowiki/><nowiki/>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 6: / سطر 6: @@
 </syntaxhighlight>
-==القيمة المُعادة==
+==القيمة المعادة==
-قيمة عددية.
+تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع القيمة <code>other</code>، أو  تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة الوسيط <code>other</code>)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==أمثلة==
-===استخدام الدالة <code>()compareTo</code>===
+<nowiki/>استعمال الدالة <code>()compareTo</code> للموازنة بين سلسلتين نصيتين:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/String|سلسلتين نصيتين]] باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()compareTo</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:
+fun main(args: Array<String>) {
-<nowiki/><nowiki/><nowiki/><syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
      val x = "hsoub"
      val y = "academy"
-     println(x.compareTo(y) )// 7
+     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/not|not()]]</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/compare-to.html الدالة  compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/compare-to.html صفحة الدالة compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]