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

المراجعة الحالية بتاريخ 13:51، 8 سبتمبر 2018

تجمع الدالة plus()‎ العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.

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

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

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

المعاملات

`other`

العدد الآخر المراد تطبيق العملية عليه.

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

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

أمثلة

استعمال الدالة ()plus لجمع عددين:

fun main(args: Array<String>) {    
    val x : Byte = 4
    val y : Byte = 2
    
    println(x.plus(y)) // 6
}

انظر أيضًا

الدالة plus()‎: تضيف الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
الدالة compareTo()‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
الدالة dec()‎: تُنقِص القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
الدالة inc()‎ : تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
الدالة div()‎: تقسِّم العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
الدالة minus()‎: تطرح العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
الدالة rangeTo()‎: تنشئ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
الدالة rem()‎: تحسب باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
الدالة times()‎: تضرب العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج.

مصادر

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

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