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