Kotlin/kotlin.text/elementAtOrElse

تعيد الدالة elementAtOrElse()‎ الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException.

البنية العامة

inline fun CharSequence.elementAt(index: Int): Char

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

القيم المعادة

حرف.

أمثلة

استخدام الدالة ()elementAtOrElse مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()elementAtOrElse عبرها مع تمرير عدد كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "wiki Hsoub" 
    
println(str.elementAt(2)) //  k
}

انظر أيضًا

• dropLast()‎: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف آخر n حرفًا.

• drop()‎: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول n حرفًا. 
• asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

• الدالة text.elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.