الفرق بين المراجعتين ل"Kotlin/Byte/rangeTo"

من موسوعة حسوب
< Kotlin‏ | Byte
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.rangeTo()‎</code> في لغة Kotlin}}</noinclude> تقارن الدالة<code>rangeTo()‎</code> بين قيمة...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.rangeTo()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.rangeTo()‎</code> في لغة Kotlin}}</noinclude>
تقارن الدالة<code>rangeTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+
تنشئ الدالة<code>rangeTo()‎</code> مجالًا من العنصر الذي استُدعيت عبره إلى القيمة المُمرّرة<nowiki/><nowiki/>.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
operator fun compareTo(other: Byte): Int
+
operator fun rangeTo(other: Byte): IntRange
operator fun compareTo(other: Short): Int
+
operator fun rangeTo(other: Short): IntRange
operator fun compareTo(other: Int): Int
+
operator fun rangeTo(other: Int): IntRange
operator fun compareTo(other: Long): Int
+
operator fun rangeTo(other: Long):
operator fun compareTo(other: Float): Int
+
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
operator fun compareTo(other: Double): Int
+
 
</syntaxhighlight>
 
 
==القيمة المُعادة==
 
==القيمة المُعادة==
قيمة عددية.
+
مجال من العنصر الذي استُدعيت الدالة عبره إلى القيمة المُمرّرة.
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()rangeTo</code>===
 
===استخدام الدالة <code>()rangeTo</code>===
تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()rangeTo</code> على x وتمرر <code>y</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>) {     
 
fun main(args: Array<String>) {     
 
     val x = 5
 
     val x = 5
     val y = 4
+
     val y = 10
 
      
 
      
     println(x.compareTo(y) )// 1
+
     println(x.rangeTo(y) )// 5..10
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 28: سطر 27:
  
 
==مصادر==
 
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/compare-to.html الدالة  Byte.rangeTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/range-to.html الدالة  Byte.rangeTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

مراجعة 16:31، 25 يونيو 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

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

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

أنظر أيضًا

  • dec()‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
  • div()‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
  • inc()‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.

مصادر