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

مراجعة 06:22، 14 أغسطس 2018

تطرح الدالة minus()‎ العدد الممرّر إليها من العدد العشري المضاعف (double) الذي استُدعي معها ثم تعيد الناتج.

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

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).

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

يعاد عدد عشري مضاعف يحوي ناتج طرح العدد other الممرّر من العدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()minus لطرح عددين عشريين من النوع Double:

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

انظر أيضًا

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

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

مصادر

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

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