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

مراجعة 15:21، 29 يونيو 2018

تقوم الدالةminus()‎ بطرح العدد الممرّر من العدد الذي استُدعيت عبره.

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

operator fun minus(other: Byte): Double 
operator fun minus(other: Short): Double
operator fun minus(other: Int): Double 
operator fun minus(other: Long): Double 
operator fun minus(other: Float): Double
operator fun minus(other: Double): Double

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

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

ناتج طرح العدد الممرّر إلى الدالة من العدد الذي استُدعيت عبره.

أمثلة

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

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

fun main(args: Array<String>) {    
    val x : Double  = 4.45
    val y : Double  = 2.322
    
    println(x.minus(y) )// 2.128
}

أنظر أيضًا

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

dec()‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
inc()‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.

مصادر

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

@@ سطر 3: / سطر 3: @@
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun minus(other: Byte): Int
+operator fun minus(other: Byte): Double
-operator fun minus(other: Short): Int
+operator fun minus(other: Short): Double
-operator fun minus(other: Int): Int
+operator fun minus(other: Int): Double
-operator fun minus(other: Long): Long
+operator fun minus(other: Long): Double
-operator fun minus(other: Float): Float
+operator fun minus(other: Float): Double
 operator fun minus(other: Double): Double
-</syntaxhighlight>
+</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
 ==القيمة المُعادة==
 ناتج طرح العدد  الممرّر  إلى الدالة من العدد الذي استُدعيت عبره.
@@ سطر 16: / سطر 17: @@
 تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>y</code> و <code>x</code>، ثم تستخدم الدالة<code>()minus</code> على x  مع تمرير <code>y</code> كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val x : Byte = 4
+     val x : Double  = 4.45
-     val y : Byte = 2
+     val y : Double  = 2.322
-     println(x.minus(y) )// 2
+     println(x.minus(y) )// 2.128
 }
 </syntaxhighlight>
 ==أنظر أيضًا==
-*<code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+*<code>[[Kotlin/Double/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* <code>[[Kotlin/Double/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* <code>[[Kotlin/Double/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/minus.html الدالة  Double.minus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-double/minus.html الدالة  Double.minus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]