الدالة elementAtOrNull() في لغة Kotlin
تعيد الدالةelementAtOrNull() العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد القيمة المعدومة null.
البنية العامة
يمكن استدعاء الدالةelementAtOrNull() على المصفوفات.
inline fun <T> Array<out T>.elementAtOrNull(index: Int): T?
inline fun ByteArray.elementAtOrNull(index: Int): Byte?
inline fun ShortArray.elementAtOrNull(index: Int): Short?
inline fun IntArray.elementAtOrNull(index: Int): Int?
inline fun LongArray.elementAtOrNull(index: Int): Long?
inline fun FloatArray.elementAtOrNull(index: Int): Float?
inline fun DoubleArray.elementAtOrNull(index: Int): Double?
inline fun BooleanArray.elementAtOrNull(index: Int): Boolean?
inline fun CharArray.elementAtOrNull(index: Int): Char?
يمكن استدعاء الدالةelementAtOrNull() على المجموعات.
fun <T> Iterable<T>.elementAtOrNull(index: Int): T?
يمكن استدعاء الدالةelementAtOrNull() على اللوائح.
inline fun <T> List<T>.elementAtOrNull(index: Int): T?
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد القيمة المعدومة null.
أمثلة
استخدام الدالة ()elementAtOrNull مع المصفوفات: الحالة الأولى
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()elementAtOrNull للحصول على العنصر الموجود عند الفهرس 2 ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
println(array.elementAtOrNull(2)) // 3
}
استخدام الدالة ()elementAtOrNull مع المصفوفات: الحالة الثانية
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()elementAtOrNull للحصول على العنصر الموجود عند الفهرس 12، ولما كان هذا الفهرس خارج حدود المصفوفة فستُعيد الدالة (12) القيمة المعدومة null ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
println(array.elementAtOrNull(12)) // null
}
انظر أيضًا
elementAt(): تعيد العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُطلق استثناءً IndexOutOfBoundsException.elementAtOrElse(): تعيد العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد ناتج تطبيق الدالة المُمرّرةdefaultValue()على الفهرس.