Kotlin/Char/minus

تقوم الدالة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.