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

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

تقوم الدالةminus()‎ بطرح ترتيب الحرف الممرّر من ترتيب الحرف الذي استُدعيت عبره وتعيد عددا من النوع Int. أما إن كان الوسيط المُمرّر عددًا، فإنّها تعيد الحرف الذي يساوي الفرق بين ترتيبه وترتيب الحرف الذي استُدعيت عبره العدد المٌمرّر.

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

operator fun minus(other: Char): Int 
operator fun minus(other: Int): Char

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

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

عدد من النوع Int إن كان الوسيط الممرّر حرفًا، أو حرفًا إن كان الوسيط المُمرّر عددًا.

أمثلة

استخدام الدالة `()minus` مع تمرير حرف كوسيط

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

fun main(args: Array<String>) {    
    val x = 'a'
    val y = 'A'
    
    print(x.minus(y) )// 32
}

استخدام الدالة `()minus` مع تمرير عدد كوسيط

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

    fun main(args: Array<String>) {    
        val x = 'a'
        val y = 7

        print(x.minus(y) )// Z
    }

أنظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>Char.minus()‎</code> في لغة Kotlin}}</noinclude>
-تقوم الدالة<code>minus()‎</code> بطرح العدد  الممرّر من العدد الذي استُدعيت عبره.
+تقوم الدالة<code>minus()‎</code> بطرح ترتيب الحرف  الممرّر من ترتيب الحرف الذي استُدعيت عبره وتعيد عددا من النوع <code>Int</code>. أما إن كان الوسيط المُمرّر عددًا، فإنّها تعيد الحرف الذي يساوي الفرق بين ترتيبه وترتيب الحرف الذي استُدعيت عبره العدد المٌمرّر.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun minus(other: Byte): Int
+operator fun minus(other: Char): Int
-operator fun minus(other: Short): Int
+operator fun minus(other: Int): Char
-operator fun minus(other: Int): Int
-operator fun minus(other: Long): Long
+</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
-operator fun minus(other: Float): Float
-operator fun minus(other: Double): Double
-</syntaxhighlight>
 ==القيمة المُعادة==
-ناتج طرح العدد  الممرّر  إلى الدالة من العدد الذي استُدعيت عبره.
+عدد من النوع  <code>Int</code> إن كان الوسيط الممرّر حرفًا، أو حرفًا إن كان الوسيط المُمرّر عددًا.
 ==أمثلة==
-===استخدام الدالة <code>()minus</code>===
+===استخدام الدالة <code>()minus</code> مع تمرير حرف كوسيط===
-تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>y</code> و <code>x</code>، ثم تستخدم الدالة<code>()minus</code> على x  مع تمرير <code>y</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 : Byte = 4
+     val x = 'a'
-     val y : Byte = 2
+     val y = 'A'
-     println(x.minus(y) )// 2
+     print(x.minus(y) )// 32
 }
+</syntaxhighlight>
+===استخدام الدالة <code>()minus</code> مع تمرير عدد كوسيط===
+تعرّف الشيفرة الآتية عددًا باسم <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 = 7
+        print(x.minus(y) )// Z
+    }
 </syntaxhighlight>
 ==أنظر أيضًا==
-*<code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+*<code>[[Kotlin/Char/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
 ==مصادر==