الدالة mapNotNullTo()‎ في لغة Kotlin

تطبق الدالةmapNotNullTo()‎ الدالة المُمررّة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى المعامل الممرّر destination.

البنية العامة

يمكن استدعاء الدالةmapNotNullTo()‎ على المصفوفات.

inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo(
    destination: C, 
    transform: (index: Int, T) -> R
): C 
inline fun <R, C : MutableCollection<in R>> ByteArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Byte) -> R
): C 
inline fun <R, C : MutableCollection<in R>> ShortArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Short) -> R
): C 
inline fun <R, C : MutableCollection<in R>> IntArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Int) -> R
): C 
inline fun <R, C : MutableCollection<in R>> LongArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Long) -> R
): C 
inline fun <R, C : MutableCollection<in R>> FloatArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Float) -> R
): C 
inline fun <R, C : MutableCollection<in R>> DoubleArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Double) -> R
): C 
inline fun <R, C : MutableCollection<in R>> BooleanArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Boolean) -> R
): C 
inline fun <R, C : MutableCollection<in R>> CharArray.mapIndexedTo(
    destination: C, 
    transform: (index: Int, Char) -> R
): C

يمكن استدعاء الدالةmapNotNullTo()‎ على المجموعات.

inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(
    destination: C, 
    transform: (index: Int, T) -> R
): C

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

القيم المٌعادة

الوسيط المُمرّر destination بعد إضافة نتائج تطبيق الدالة المُمررّة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.

أمثلة

استخدام الدالة ()mapNotNullTo مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًة من ستة أعداد باستخدام الدالة ()arrayOf، وتعرّف كائنًا من النوع mapNotNullTo باسم mutable، ثم تستخدم الدالة  ()mapIndexedTo على array، مع تمرير الكائن mutable ودالة تعيد مجموع قيمة العنصر وقيمة فهرسه، ثم تطبع mutable:

fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
val mutable: MutableList<Int> = mutableListOf()
    
array.mapIndexedTo (mutable) { a, b -> a + b }
    
println(mutable)   //  [0, 3, 4, 7, 11, 10]
}

انظر أيضًا

• mapIndexed()‎: تضيف إلى اللائحة المُمرّرة إليها ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة أو القاموس وفهارسها.
• map()‎: تعيد لائحة تضم ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة map()‎ على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة transform()‎ على مداخل (entries) القاموس.

• mapIndexedNotNull()‎: تعيد لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالة transform()‎ على عناصر المصفوفة أوالمجموعة التي استُدعيت عبرها وعلى فهارسها.

مصادر

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