الفرق بين المراجعتين لصفحة: «Kotlin/ranges/downTo»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE:الدالة <code>downTo()</code> في Kotlin}}</noinclude> | ||
تنشئ الدالة <code>downTo()</code> مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. ينبغي أن تكون القيمة الممرَّرة أصغر من القيمة التي استُدعيت معها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 23: | سطر 23: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == المعاملات == | ||
== | === <code>to</code> === | ||
القيمة العددية الدنيا التي سيُنشَأ منها المجال. | |||
=== | == القيم المعادة == | ||
يعاد مجالٌ متدرجٌ (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة <code>to</code> الممرّرة. | |||
== أمثلة == | |||
استعمال الدالة <code>downTo()</code> لطباعة القيم الواقعة بين العدد 9 والعدد 4:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val x = 9 | val x = 9 | ||
| سطر 39: | سطر 42: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==<nowiki/> | ==ا<nowiki/>نظر أيضًا == | ||
* | *الدالة <code>[[Kotlin/Char/rangeTo|rangeTo()]]</code>: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها. | ||
*الدالة [[Kotlin/ranges/until|<code>until()</code>]]: تنشئ مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). | |||
==مصادر== | ==مصادر== | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.ranges/down-to.html الدالة | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.ranges/down-to.html صفحة الدالة ()downTo في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Koltin Function]] | ||
[[تصنيف:Kotlin Range]] | |||
المراجعة الحالية بتاريخ 04:40، 9 سبتمبر 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
المعاملات
to
القيمة العددية الدنيا التي سيُنشَأ منها المجال.
القيم المعادة
يعاد مجالٌ متدرجٌ (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(): تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها. - الدالة
until(): تنشئ مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).