الدالة `mapIndexedNotNull()‎` في لغة Kotlin

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

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

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

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

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

inline fun <T, R> Iterable<T>.mapIndexed(
    transform: (index: Int, T) -> R
): List<R>

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

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

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

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًا من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()mapIndexedNotNull على array، مع تمرير دالة، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)

array.mapIndexed{index, element  -> print("$element:$index ") }
    // 1:0 2:1 3:2 4:3 5:4 6:5 
}

انظر أيضًا

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

مصادر

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