عرض مصدر Kotlin/ranges/until

<noinclude>{{DISPLAYTITLE:الدالة <code>‎until()‎</code> في Kotlin}}</noinclude>
تنشئ الدالة ‎<code>until()‎</code> مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). 
==البنية العامة==
<syntaxhighlight lang="kotlin">
infix fun Int.until(to: Byte): IntRange 
infix fun Long.until(to: Byte): LongRange 
infix fun Byte.until(to: Byte): IntRange 
infix fun Short.until(to: Byte): IntRange 
infix fun Long.until(to: Int): LongRange 
infix fun Int.until(to: Short): IntRange 
infix fun Long.until(to: Short): LongRange 
infix fun Byte.until(to: Short): IntRange 
infix fun Short.until(to: Short): IntRange
</syntaxhighlight>تنشئ الدالة ‎<code>until()‎</code> مجالًا تصاعديًا يبدأ من القيمة التي استُدعيت معها وينتهي عند القيمة <code>to</code> الممرّرة إليها (لا تدخل ضمن المجال). ينبغي أن تكون القيمة <code>to</code> المُمرَّرة أكبر من القيمة التي استُدعيت معها الدالة، وإلّا فستعيد الدالة مجالًا فارغًا.<syntaxhighlight lang="kotlin">
infix fun Char.until(to: Char): CharRange 

</syntaxhighlight>تنشئ الدالة ‎<code>until()‎</code> مجالًا تصاعديًا من المحارف يبدأ من المحرف <code>Char</code> الذي استُدعي معها وينتهي عند المحرف <code>to</code> الممرّرة إليها (لا تدخل ضمن المجال). يجب أن يكون المحرف <code>to</code> المُمرّر أكبر من المحرف <code>'‎\u0000'</code> أو ستعيد الدالة مجالًا فارغًا.<syntaxhighlight lang="kotlin">
infix fun Int.until(to: Int): IntRange 
infix fun Byte.until(to: Int): IntRange 
infix fun Short.until(to: Int): IntRange
</syntaxhighlight>تنشئ الدالة ‎<code>until()‎</code> مجالًا تصاعديًا يبدأ من القيمة التي استُدعيت معها وينتهي عند القيمة <code>to</code> الممرّرة إليها (لا تدخل ضمن المجال). ينبغي أن تكون القيمة <code>to</code> الممرَّرة أكبر من القيمة <code>[[Kotlin/Int/MIN VALUE|Int.MIN_VALUE]]</code>، وإلّا فستعيد الدالة مجالًا فارغًا.<syntaxhighlight lang="kotlin">
infix fun Int.until(to: Long): LongRange 
infix fun Long.until(to: Long): LongRange 
infix fun Byte.until(to: Long): LongRange
infix fun Short.until(to: Long): LongRange 
</syntaxhighlight>تنشئ الدالة ‎<code>until()‎</code> مجالًا تصاعديًا يبدأ من القيمة التي استُدعيت معها وينتهي عند القيمة <code>to</code> الممرّرة إليها (لا تدخل ضمن المجال). ينبغي أن تكون القيمة الممرَّرة أكبر من القيمة <code>[[Kotlin/Long/MIN VALUE|Long.MIN_VALUE]]</code>، وإلّا فستعيد الدالة مجالا فارغًا.

وجود الكلمة المفتاحية <code>infix</code> يدل على أنَّ هذه الدالة يمكن استدعاؤها بنمط [[Kotlin/functions#.D8.A7.D9.84.D8.AA.D8.AF.D9.88.D9.8A.D9.86 .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D9.91 .28Infix notation.29|التدوين الداخليّ]] (infix notation)؛ أي من خلال حذف المعامل <code>.</code>والأقواس <code>()</code> المُستخدَمَين في الاستدعاء عادةً.
==المعاملات==

=== <code>to</code> ===
القيمة القصوى التي سيُنشَأ منها المجال.

==القيمة المعادة==
يعاد مجالٌ تصاعديٌّ يبدأ من القيمة المعطاة وينتهي عند القيمة <code>to</code> المُمرَّرة ولا تدخل هذه القيمة ضمن المجال.
==مثال==
استعمال الدالة <code>until()‎</code> لإنشاء مجال من الأعداد الصحيحة ومجال من الأحرف:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {    
    val x = 5
    val y = 'a'

    print(x.until(9)) // 5..8
    print(y.until('f')) // a..e
}

</syntaxhighlight>
==انظر أيضًا==
* الدالة <code>[[Kotlin/Char/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
*الدالة<nowiki/>[[Kotlin/ranges/downTo|<code>downTo()</code>]]‎ : تنشئ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها.
* الدالة <code>[[Kotlin/Char/compareTo|compareTo()]]</code>‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.ranges/until.html صفحة الدالة ()until في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Koltin Function]]
[[تصنيف:Kotlin Range]]