الدالة `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()‎ على عناصر المصفوفة أوالمجموعة التي استُدعيت عبرها وعلى فهارسها.

مصادر

الدالة mapNotNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.