الدالة text.elementAtOrNull()‎ في لغة Kotlin

تعيد الدالة elementAtOrNull()‎ الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد null.

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

inline fun CharSequence.elementAtOrNull(index: Int): Char?

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

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

حرف.

أمثلة

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

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

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

انظر أيضًا

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

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

مصادر

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