الدالة getOrNull() في لغة Kotlin
تعيد الدالة getOrNull() قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو 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?
يمكن استدعاء الدالة getOrElse() عبر المجموعات:
fun <T> List<T>.getOrNull(index: Int): T?
القيم المعادة
قيمة العنصر عند الفهرس 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، ولما كان هذا الفهرس خارج الحدود، فستعيد الدالة ()getOrNull القيمة المعدومة null:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
print(array.getOrNull(8)) // null
}
انظر أيضًا
getOrElse(): تعيد قيمة العنصر عند الفهرسindexالمُحدَّد في المصفوفة أو المجموعة التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرةdefaultValueإن كان الفهرس خارج الحدود. ان استُدعيت الدالة عبر قاموس فستُعيد القيمة المقابلة للمفتاحkeyالمُمرّر إلى الدالة، أو نتيجة استدعاء الدالة المُمرّرةdefaultValueإن كان المفتاحkeyموجودًا.