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

من موسوعة حسوب
< Kotlin‏ | ranges
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الثابتة <code>Char.ranges()</code> في لغة Kotlin}}</noinclude> تعيد <code>ranges()</code> اتجاه الحرف (Unicode direc...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الثابتة <code>Char.ranges()</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الثابتة <code>‎Char.ranges()‎</code> في لغة Kotlin}}</noinclude>
تعيد <code>ranges()</code> اتجاه الحرف (Unicode directionality property) الذي استُدعيت عبره.
تعيد الدالة ‎<code>ranges()‎</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>
== القيمة المُعادة ==
مجال متدرّج (progression) تنازلي.


== مثال ==
== مثال ==


=== استخدام <code>ranges()</code>  ===
=== استخدام الدالة <code>ranges()‎</code>  ===
في الشيفرة التالية نعرّف ثلاثة أحرف أسماؤها <code>x</code> و <code>y</code> و <code>z</code>،  ثم نستدعي القيمة <code>ranges()</code> عبرها، ثم نطبع الناتج:<syntaxhighlight lang="kotlin">
في الشيفرة التالية نعرّف عددين <code>x</code> و <code>y</code>، ثم نعرّف مجال متدرّج <code>p</code> عبر استدعاء الدالة<code>ranges()‎</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>) {     
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/MIN LOW SURROGATE|MIN_LOW_SURROGATE]]</code>‎ : تساوي  القيمة الدنيا للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit).
*الثابتة<code>[[Kotlin/text/category|category]]</code>‎ : تساوي القيمة القصوى لبديل وحدة اليونيكود  (Unicode surrogate code unit).
*الثابتة<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]]
[[تصنيف:Kotlin functions]]

مراجعة 17:06، 1 يوليو 2018

تعيد الدالة ‎ranges()‎ مجالا متدرّجًا (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) تنازلي.

مثال

استخدام الدالة ranges()‎

في الشيفرة التالية نعرّف عددين x و y، ثم نعرّف مجال متدرّج p عبر استدعاء الدالةranges()‎ عبر x ونمرر إليها الوسيط y ، ثم نستخدم p في حلقة for:

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

أنظر أيضًا

  • الثابتةcategory‎ : تساوي القيمة القصوى لبديل وحدة اليونيكود (Unicode surrogate code unit).

مصادر

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