الدالة Char.rangeTo() في Kotlin
تنشئ الدالة rangeTo() مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
البنية العامة
operator fun rangeTo(other: Char): CharRange
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
القيمة المعادة
يعاد مجالٌ ينحصر بين المحرف المعطى والمحرف other الممرر.
أمثلة
استعمال الدالة ()rangeTo لإنشاء مجال من المحارف يقع بين المحرف 'a' والمحرف 'd':
fun main(args: Array<String>) {
val x = 'a'
val y = 'd'
println(x.rangeTo(y)) // a..d
}
انظر أيضًا
- الدالة
downTo(): تنشئ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. - الدالة
until(): تنشئ مجالًا تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). - الدالة
compareTo(): توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. - الدالة
dec(): تعيد المحرف السابق للمحرف الذي استُدعيت معه. - الدالة
inc() : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه. - الدالة
minus(): تطرح القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوعIntيمثل الناتج. وإن مرِّر إليها عدد صحيح من النوعInt، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه. - الدالة
plus(): تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة. - الدالة
toInt(): تحوّل المحرف الذي استُدعي معها إلى قيمته العددية المقابلة.