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

مراجعة 06:17، 15 أغسطس 2018

تعيد الدالة unaryMinus()‎ القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها.

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

operator fun unaryMinus(): Double

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

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

يعاد عدد عشري مضاعف يمثل القيمة السالبة للعدد العشري المضاعف المعطى.

أمثلة

استعمال الدالة ()unaryMinus لإعادة قيمة سالبة لعدد عشري مضاعف موجب وآخر سالب:

fun main(args: Array<String>) {
    val x: Double = 52.5

    val y = x.unaryMinus()
    println(y) // -52.5

    val z = y.unaryMinus()
    println(z) // 52.5
}

انظر أيضًا

الدالة unaryPlus()‎: تعيد القيمة التي استدعيت معها.
الدالة minus()‎: تطرح العدد الممرّر إليها من العدد العشري المضاعف (double) الذي استُدعي معها ثم تعيد الناتج.
الدالة dec()‎: تُنقِص العدد العشري المضاعف (double) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة.

مصادر

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

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