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

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

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

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

inline fun CharSequence.elementAtOrNull(index: Int): Char?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة).

المعاملات

index

عدد صحيح يمثل فهرس المحرف المراد جلبه من سلسلة المحارف المعطاة.

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

يُعاد المحرف ذي الفهرس index والموجود ضمن نطاق سلسلة المحارف المعطاة، أو تعاد القيمة العدمية null إن كان فهرس المحرف المعطى يقع خارج حدود سلسلة المحارف.

أمثلة

مثالٌ على استعمال الدالة ()elementAtOrNull:
fun main(args: Array<String>) {
    val str = "wiki Hsoub"

    println(str.elementAtOrNull(2)) //  k
    println(str.elementAtOrNull(10)) //  null
}

انظر أيضًا

مصادر