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

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

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

fun CharSequence.getOrNull(index: Int): Char?

المعاملات

index

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

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

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

أمثلة

مثالٌ على استعمال الدالة ()getOrNull:

fun main(args: Array<String>) {
    val str = "Hsoub"

    print(str.getOrNull(3)) // => u
    print(str.getOrNull(5)) // => null
}

انظر أيضًا

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

مصادر

• صفحة الدالة CharSequence.getOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.