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

مراجعة 07:28، 10 أغسطس 2018

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

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

operator fun rangeTo(other: Byte): IntRange 
operator fun rangeTo(other: Short): IntRange 
operator fun rangeTo(other: Int): IntRange 
operator fun rangeTo(other: Long):

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

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

يعاد مجالٌ ينحصر بين القيمة التي استدعيت مع الدالة والقيمة الممررة إليها.

أمثلة

استعمال الدالة ()rangeTo لإنشاء مجال من الأعداد ينحصر بين العدد 5 والعدد 10:

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

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.rangeTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.rangeTo()‎</code> في Kotlin}}</noinclude>
-تنشئ الدالة<code>rangeTo()‎</code> مجالًا من العنصر الذي استُدعيت عبره إلى القيمة المُمرّرة<nowiki/><nowiki/>.
+تنشئ الدالة <code>rangeTo()‎</code> مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها<nowiki/><nowiki/>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 7: / سطر 7: @@
 operator fun rangeTo(other: Int): IntRange
 operator fun rangeTo(other: Long):
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
+</syntaxhighlight>وجود الكلمة المفتاحيّة <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
-==القيمة المُعادة==
+==القيمة المعادة==
-مجال من العنصر الذي استُدعيت الدالة عبره إلى القيمة المُمرّرة.
+يعاد مجالٌ ينحصر بين القيمة التي استدعيت مع الدالة والقيمة الممررة إليها.
 ==أمثلة==
-===استخدام الدالة <code>()rangeTo</code>===
+<nowiki/>استعمال الدالة <code>()rangeTo</code> لإنشاء مجال من الأعداد ينحصر بين العدد 5 والعدد 10:<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 = 5
@@ سطر 21: / سطر 20: @@
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
-* <code>[[Kotlin/Byte/div|div()]]</code>‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+*الدالة <code>[[Kotlin/Byte/dec|dec()‎]]</code>: تُنقِص القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/Byte/div|div()]]</code>‎: تقسِّم العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Byte/minus|minus()‎]]</code>: تطرح العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Byte/plus|plus()‎]]</code>: تجمع العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Byte/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
+*الدالة <code>[[Kotlin/Byte/rem|rem()‎]]</code>: تحسب باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
+*الدالة <code>[[Kotlin/Byte/times|times()‎]]</code>: تضرب العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/range-to.html الدالة  Byte.rangeTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/range-to.html صفحة الدالة Byte.rangeTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]