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

من موسوعة حسوب
< Kotlin‏ | ranges
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الثابتة <code>Char.ranges()</code> في لغة Kotlin}}</noinclude> تعيد <code>ranges()</code> اتجاه الحرف (Unicode direc...'
 
طلا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الثابتة <code>Char.ranges()</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>‎downTo()‎</code> في Kotlin}}</noinclude>
تعيد <code>ranges()</code> اتجاه الحرف (Unicode directionality property) الذي استُدعيت عبره.
تنشئ الدالة ‎<code>downTo()‎</code> مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. ينبغي أن تكون القيمة الممرَّرة أصغر من القيمة التي استُدعيت معها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
val Char.directionality: CharDirectionality
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


</syntaxhighlight>
</syntaxhighlight>


== مثال ==
== المعاملات ==


=== استخدام <code>ranges()</code> ===
=== <code>to</code> ===
في الشيفرة التالية نعرّف ثلاثة أحرف أسماؤها <code>x</code> و <code>y</code> و <code>z</code>،  ثم نستدعي القيمة <code>ranges()</code> عبرها، ثم نطبع الناتج:<syntaxhighlight lang="kotlin">
القيمة العددية الدنيا التي سيُنشَأ منها المجال.
 
== القيم المعادة ==
يعاد مجالٌ متدرجٌ (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة <code>to</code> الممرّرة.
 
== أمثلة ==
استعمال الدالة <code>downTo()‎</code> لطباعة القيم الواقعة بين العدد 9 والعدد 4:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {     
fun main(args: Array<String>) {     
     val x = 'a'
     val x = 9
     val y = 'أ'
     val y = 4
     val z = '4'
     val p = x.downTo(y)
      
      
     println(x.directionality ) // LEFT_TO_RIGHT
     for (a in p) print(a) // 987654
    println(y.directionality ) // RIGHT_TO_LEFT_ARABIC
    println(z.directionality ) // EUROPEAN_NUMBER
}
}
</syntaxhighlight>
</syntaxhighlight>


==<nowiki/>أنظر أيضًا ==
==ا<nowiki/>نظر أيضًا ==
*الثابتة<code>[[Kotlin/Char/MAX SURROGATE|MAX_SURROGATE]]</code>‎ : تساوي القيمة القصوى لبديل وحدة اليونيكود  (Unicode surrogate code unit).
*الدالة <code>[[Kotlin/Char/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
*الثابتة<code>[[Kotlin/Char/MIN LOW SURROGATE|MIN_LOW_SURROGATE]]</code>‎ : تساوي  القيمة الدنيا للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit).
*الدالة [[Kotlin/ranges/until|‎<code>until()‎</code>]]: تنشئ مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). 
*الثابتة<code>[[Kotlin/text/category|category]]</code>‎ : تساوي القيمة القصوى لبديل وحدة اليونيكود  (Unicode surrogate code unit).
==مصادر==
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/directionality.html الدالة  downTo في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.ranges/down-to.html صفحة الدالة ()downTo في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin constant]]
[[تصنيف: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) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). 

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/ranges/downTo&oldid=17379»