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

تشبه الدالة mapTo()‎ الدالة map()‎ باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

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

يمكن استدعاء الدالة mapTo()‎ مع المصفوفات والمجموعات والخرائط:

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

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

inline fun <K, V, R, C : MutableCollection<in R>> Map<out K, V>.mapTo(
    destination: C, 
    transform: (Entry<K, V>) -> R
): C

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

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

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

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()mapTo لضرب قيمة كل عنصر من عناصر تلك المصفوفة بالقيمة 10 ثم تخزين الناتج في القائمة المتغيرة mutable:

fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
val mutable: MutableList<Int> = mutableListOf()
    
array.mapTo (mutable) { a -> a*10  }
    
println(mutable)   // [0, 20, 20, 40, 70, 50]
}

انظر أيضًا

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

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

مصادر

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