الدالة mapIndexedNotNull() في لغة Kotlin
تعيد الدالةmapIndexedNotNull() لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.
البنية العامة
يمكن استدعاء الدالةmapIndexedNotNull() على المصفوفات.
inline fun <T, R : Any> Array<out T>.mapIndexedNotNull(
transform: (index: Int, T) -> R?
): List<R>
يمكن استدعاء الدالةmapIndexedNotNull() على المجموعات.
inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull(
transform: (index: Int, T) -> R?
): List<R>
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.
أمثلة
استخدام الدالة ()mapIndexedNotNull مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًا من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()mapIndexedNotNull على array، مع تمرير دالة تعيد null إن كانت قيمة العنصر تخالف قيمة فهرسه أو تعيد العنصر نفسه، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
println(array.mapIndexedNotNull { a, b -> if (a==b) a else null }) // [0, 2, 5]
}
انظر أيضًا
mapIndexed(): تضيف إلى اللائحة المُمرّرة إليها ناتج تطبيق الدالةtransform()المُمرّرة إليها على عناصر المصفوفة أو المجموعة أو القاموس وفهارسها.map(): تعيد لائحة تضم ناتج تطبيق الدالةtransform()المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالةmap()على قاموس فستعيد لائحة تضم ناتج تطبيق الدالةtransform()على مداخل (entries) القاموس.