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

مراجعة 05:59، 11 أغسطس 2018

تنشئ الدالة rangeTo()‎ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.

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

operator fun rangeTo(other: Char): CharRange

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

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

يعاد مجالٌ ينحصر بين المحرف المعطى والمحرف other الممرر.

أمثلة

استعمال الدالة ()rangeTo لإنشاء مجال من المحارف يقع بين المحرف 'a' والمحرف 'd':

fun main(args: Array<String>) {    
    val x = 'a'
    val y = 'd'
    
    println(x.rangeTo(y)) // a..d
}

انظر أيضًا

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

مصادر

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

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