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

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

تطرح الدالة minus()‎ القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع Int يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع Int، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه.

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

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

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

المعاملات

`other`

محرفٌ أو عددٌ صحيحٌ يراد طرحه من المحرف المعطى.

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

إن كان الوسيط other محرفًا، فيعاد عدد صحيح من النوع Int يمثل حاصل طرح القيمة العددية للمحرف other من القيمة العددية للمحرف المعطى؛ أما إن كان الوسيط other عددًا صحيحًا، فيعاد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للمحرف المعطى.

أمثلة

استعمال الدالة ()minus لطرح الحرف 'A' من الحرف 'a':

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

استعمال الدالة ()minus لطرح العدد 7 من الحرف 'a':

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

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

انظر أيضًا

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

مصادر

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

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