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

مراجعة 13:52، 12 أغسطس 2018

تنشئ الدالة ‎downTo()‎ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. ينبغي أن تكون القيمة الممرَّرة أصغر من القيمة التي استُدعيت معها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.

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

infix fun Int.downTo(to: Byte): IntProgression 
infix fun Long.downTo(to: Byte): LongProgression 
infix fun Byte.downTo(to: Byte): IntProgression 
infix fun Short.downTo(to: Byte): IntProgression 
infix fun Char.downTo(to: Char): CharProgression 
infix fun Int.downTo(to: Int): IntProgression 
infix fun Long.downTo(to: Int): LongProgression 
infix fun Byte.downTo(to: Int): IntProgression 
infix fun Short.downTo(to: Int): IntProgression
infix fun Int.downTo(to: Long): LongProgression 
infix fun Long.downTo(to: Long): LongProgression 
infix fun Byte.downTo(to: Long): LongProgression 
infix fun Short.downTo(to: Long): LongProgression 
infix fun Int.downTo(to: Short): IntProgression 
infix fun Long.downTo(to: Short): LongProgression 
infix fun Byte.downTo(to: Short): IntProgression 
infix fun Short.downTo(to: Short): IntProgression

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

يعاد مجالٌ متدرجٌ (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة to الممرّرة.

أمثلة

استعمال الدالة downTo()‎ لطباعة القيم الواقعة بين العدد 9 والعدد 4:

fun main(args: Array<String>) {    
    val x = 9 
    val y = 4
    val p = x.downTo(y) 
    
    for (a in p) print(a) // 987654
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الثابتة <code>‎downTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>‎downTo()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة ‎<code>downTo()‎</code> مجالا متدرّجًا (progression) تنازليًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة. ينبغي أن تكون القيمة الممررة أصغر من القيمة التي استُدعيت عبرها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.
+تنشئ الدالة ‎<code>downTo()‎</code> مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. ينبغي أن تكون القيمة الممرَّرة أصغر من القيمة التي استُدعيت معها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 23: / سطر 23: @@
 </syntaxhighlight>
-== القيمة المُعادة ==
+== القيم المعادة ==
-مجال متدرّج (progression) تنازلي.
+يعاد مجالٌ متدرجٌ (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة <code>to</code> الممرّرة.
-== مثال ==
+== أمثلة ==
+استعمال الدالة <code>downTo()‎</code> لطباعة القيم الواقعة بين العدد 9 والعدد 4:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>downTo()‎</code>  ===
-في الشيفرة التالية نعرّف عددين <code>x</code> و <code>y</code>، ثم نعرّف مجال متدرّج <code>p</code> عبر استدعاء الدالة<code>downTo()‎</code> عبر <code>x</code> ونمرر إليها الوسيط <code>y</code> ، ثم نستخدم <code>p</code> في حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val x = 9
@@ سطر 39: / سطر 37: @@
 </syntaxhighlight>
-==<nowiki/>أنظر أيضًا ==
+==ا<nowiki/>نظر أيضًا ==
-*الثابتة<code>[[Kotlin/text/category|category]]</code>‎ : تساوي القيمة القصوى لبديل وحدة اليونيكود  (Unicode surrogate code unit).
+*الدالة <code>[[Kotlin/Char/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.ranges/down-to.html الدالة  downTo في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.ranges/down-to.html صفحة الدالة ()downTo في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin functions]]