الفرق بين المراجعتين لصفحة: «Kotlin/collections/mapIndexed»

مراجعة 18:10، 29 مايو 2018

تعيد الدالةmapIndexed()‎ لائحة تضم ناتج تطبيق الدالة 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()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًا من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()mapIndexed على 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()‎: تعيد لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.

مصادر

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

@@ سطر 53: / سطر 53: @@
 *<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
 *<code>[[Kotlin/collections/map|map()]]</code>‎: تعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) <nowiki/>[[Kotlin/collections/Map|القاموس]].
+*<code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|لائحة]] تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها.
 ==مصادر==
 *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed.html الدالة  mapIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]