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

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

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

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

operator fun compareTo(other: Byte): 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

حلت الدالة Comparable.compareTo()‎ مكان الأشكال السابقة من هذه الدالة.

operator fun compareTo(other: Double): Int

وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).

المعاملات

`other`

العدد الآخر المراد موازنته.

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

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

أمثلة

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

fun main(args: Array<String>) {    
    val x: Float = 5.5f
    val y: Float = 4.45f
    
    println(x.compareTo(y)) // 1
}

انظر أيضًا

الدالة dec()‎: تُنقِص العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
الدالة inc()‎ : تزيد العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
الدالة div()‎: تقسِّم العدد العشري (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج.
الدالة minus()‎: تطرح العدد الممرّر إليها من العدد العشري (float) الذي استُدعي معها ثم تعيد الناتج.
الدالة plus()‎: تجمع العدد العشري (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.
الدالة rem()‎: تحسب باقي عملية قسمة العدد العشري (double) الذي استُدعي معها على العدد الممرّر إليها.
الدالة times()‎: تضرب العدد الممرّر إليها بالعدد العشري (float) المستدعى معها ثمَّ تعيد الناتج.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Float.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Float.compareTo()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+<nowiki/><nowiki/>توازن الدالة <code>compareTo()‎</code> بين [[Kotlin/Float|عدد عشري]] (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 8: / سطر 8: @@
 operator fun compareTo(other: Long): Int
 operator fun compareTo(other: Float): Int
+</syntaxhighlight>حلت الدالة [[Kotlin/Comparable/compareTo|<code>Comparable.compareTo()‎</code>]] مكان الأشكال السابقة من هذه الدالة.<syntaxhighlight lang="kotlin">
 operator fun compareTo(other: Double): Int
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
+</syntaxhighlight>وجود الكلمة المفتاحيّة <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
+== المعاملات ==
+=== <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>) {
-     val x : Float = 5.5f
+     val x: Float = 5.5f
-     val y : Float = 4.45f
+     val y: Float = 4.45f
-     println(x.compareTo(y) )// 1
+     println(x.compareTo(y)) // 1
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* <code>[[Kotlin/Float/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/Float/dec|dec()‎]]</code>: تُنقِص [[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
-* <code>[[Kotlin/Float/div|div()]]</code>‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+*الدالة <code>[[Kotlin/Float/inc|inc()]]</code>‎ : تزيد [[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.
-* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/Float/div|div()]]</code>‎: تقسِّم [[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج.
+*الدالة <code>[[Kotlin/Float/minus|minus()‎]]</code>: تطرح العدد الممرّر إليها من [[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Float/plus|plus()‎]]</code>: تجمع [[Kotlin/Float|العدد العشري]] (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Float/rem|rem()‎]]</code>: تحسب باقي عملية قسمة [[Kotlin/Float|العدد العشري]] (double) الذي استُدعي معها على العدد الممرّر إليها.
+*الدالة <code>[[Kotlin/Float/times|times()‎]]</code>: تضرب العدد الممرّر إليها [[Kotlin/Float|بالعدد العشري]] (float) المستدعى معها ثمَّ تعيد الناتج.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/compare-to.html الدالة  Float.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/compare-to.html صفحة الدالة Float.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Float]]