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

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

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

يمكن استدعاء الدالة getOrElse()‎ مع المصفوفات:

fun <T> Array<out T>.getOrNull(index: Int): T? 
fun ByteArray.getOrNull(index: Int): Byte? 
fun ShortArray.getOrNull(index: Int): Short? 
fun IntArray.getOrNull(index: Int): Int? 
fun LongArray.getOrNull(index: Int): Long? 
fun FloatArray.getOrNull(index: Int): Float? 
fun DoubleArray.getOrNull(index: Int): Double? 
fun BooleanArray.getOrNull(index: Int): Boolean? 
fun CharArray.getOrNull(index: Int): Char?

ويمكن استدعاؤها مع المجموعات أيضًا:

fun <T> List<T>.getOrNull(index: Int): T?

المعاملات

index

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

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

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

أمثلة

استخدام الدالةgetOrNull()‎ على مصفوفة: العنصر موجود

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()getOrNull لجلب قيمة العنصر ذي الفهرس 2:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.getOrNull(2)) // 3
}

استخدام الدالةgetOrNull()‎ على مصفوفة: العنصر غير موجود

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()getOrNull لجلب قيمة العنصر ذي الفهرس 8:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.getOrNull(8)) // null
}

انظر أيضًا

• الدالة getOrElse()‎: تجلب عنصرًا ذي فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة. إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة أو كان المفتاح المعطى غير موجود في الخريطة، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
• الدالة filter()‎: ترشِّح عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
• الدالة filterNotNull()‎: تعيد جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمة null.

مصادر

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