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

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

تجمع الدالة plus()‎ القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.

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

operator fun plus(other: Int): Char

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

المعاملات

`other`

عدد صحيح يراد جمعه مع القيمة العددية للمحرف المعطى.

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

يعاد المحرف الذي قيمته العددية هي حاصل جمع القيمة العددية other الصحيحة مع القيمة العددية للمحرف المعطى.

أمثلة

استعمال الدالة ()plus لجمع العدد 7 مع الحرف 'a':

fun main(args: Array<String>) {    
    val x = 'a'
    val y = 7
    
    print(x.plus(y)) // h
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Char.plus()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Char.plus()‎</code> في Kotlin}}</noinclude>
-تقوم الدالة<code>plus()‎</code> بطرح ترتيب الحرف  الممرّر من ترتيب الحرف الذي استُدعيت عبره وتعيد عددا من النوع <code>Int</code>. أما إن كان الوسيط المُمرّر عددًا، فإنّها تعيد الحرف الذي يساوي الفرق بين ترتيبه وترتيب الحرف الذي استُدعيت عبره العدد المٌمرّر.
+تجمع الدالة <code>plus()‎</code> القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun minus(other: Char): Int
+operator fun plus(other: Int): Char
-operator fun minus(other: Int): Char
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
+</syntaxhighlight>وجود الكلمة المفتاحيّة <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
-==القيمة المُعادة==
+== المعاملات ==
-عدد من النوع  <code>Int</code> إن كان الوسيط الممرّر حرفًا، أو حرفًا إن كان الوسيط المُمرّر عددًا.
+=== <code>other</code> ===
+عدد صحيح يراد جمعه مع القيمة العددية للمحرف المعطى.
+==القيمة المعادة==
+يعاد المحرف الذي قيمته العددية هي حاصل جمع القيمة العددية <code>other</code> الصحيحة مع القيمة العددية للمحرف المعطى.
 ==أمثلة==
-===استخدام الدالة <code>()minus</code> مع تمرير حرف كوسيط===
+<nowiki/>استعمال الدالة <code>()plus</code> لجمع العدد 7 مع الحرف 'a':<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 = 'a'
-     val y = 'A'
+     val y = 7
-     print(x.minus(y) )// 32
+     print(x.plus(y)) // h
 }
 </syntaxhighlight>
-===استخدام الدالة <code>()plus</code> مع تمرير عدد كوسيط===
+==انظر أيضًا==
-تعرّف الشيفرة الآتية عددًا باسم <code>y</code> وحرفًا باسم <code>x</code>، ثم تستخدم الدالة<code>()plus</code> على x  مع تمرير <code>y</code> كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+*الدالة <code>[[Kotlin/Char/compareTo|compareTo()]]</code>‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
-    fun main(args: Array<String>) {
+*الدالة <code>[[Kotlin/Char/dec|dec()‎]]</code>: تعيد المحرف السابق للمحرف الذي استُدعيت معه.
-        val x = 'a'
+*الدالة <code>[[Kotlin/Char/inc|inc()]]</code>‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
-        val y = 7
+*الدالة <code>[[Kotlin/Char/minus|minus()‎]]</code>: تطرح القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع <code>[[Kotlin/Int|Int]]</code> يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع [[Kotlin/Int|<code>Int</code>]]، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه.
+*الدالة <code>[[Kotlin/Char/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
-        print(x.minus(y) )// Z
-    }
-</syntaxhighlight>
-==أنظر أيضًا==
-*<code>[[Kotlin/Char/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char/minus.html الدالة  Char.plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char/plus.html صفحة الدالة Char.plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Char]]