عرض مصدر Kotlin/collections/mapIndexed

<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>mapIndexed()‎</code> [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.

==البنية العامة==
يمكن استدعاء الدالة <code>mapIndexed()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
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> 

inline fun <T, R> Iterable<T>.mapIndexed(
    transform: (index: Int, T) -> R
): List<R>
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>transform</code> ===
دالةٌ تطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر.

==القيم المعادة==
تُعاد قائمةٌ تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة.
==أمثلة==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()mapIndexed</code> لوضع فهرس كل عنصر بجانب قيمته وفقًا لتنسيق معين<nowiki/>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    array.mapIndexed{ index, element -> print("$index:$element, ") }
    // 0:1, 1:2, 2:3, 3:4, 4:5, 5:6, 
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo()‎]]</code>: تشبه هذه الدالة في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
*الدالة [[Kotlin/collections/map|<code>map()</code>]]‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
*الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
*الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
* الدالة <nowiki/>[[Kotlin/collections/filterIndexed|<code>filterIndexed()</code>‎]]: ترشِّح ترشِّح عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي تُعاد القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed.html صفحة الدالة mapIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]