الفرق بين المراجعتين ل"Kotlin/collections/mapIndexedNotNullTo"
| سطر 18: | سطر 18: | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()mapIndexedNotNullTo</code> مع المصفوفات=== | ===استخدام الدالة <code>()mapIndexedNotNullTo</code> مع المصفوفات=== | ||
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًا من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code> | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًا من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code>MutableList<Int></code> باسم <code>mutable</code>، ثم تستخدم الدالة <code>()mapIndexedNotNullTo</code> على <code>array</code><nowiki/>، مع تمرير <code>mutable</code> ودالة تعيد <code>null</code> إن كانت قيمة العنصر تخالف قيمة فهرسه أو تعيد العنصر نفسه، ثم تطبع <code>mutable</code>:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(0, 2, 2, 4, 7, 5) | val array = arrayOf(0, 2, 2, 4, 7, 5) | ||
مراجعة 19:30، 29 مايو 2018
تطبق الدالةmapIndexedNotNullTo() الدالة المُمررّة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها وتضيف فقط النتائج غير المعدومة (non-null) إلى المعامل الممرّر destination.
البنية العامة
يمكن استدعاء الدالةmapIndexedNotNullTo() على المصفوفات.
inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapIndexedNotNullTo(
destination: C,
transform: (index: Int, T) -> R?
): C
يمكن استدعاء الدالةmapIndexedNotNullTo() على المجموعات.
inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo(
destination: C,
transform: (index: Int, T) -> R?
): C
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
الوسيط المُمرّر destination بعد إضافة النتائج غير المعدومة (non-null) لتطبيق الدالة المُمررّة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
أمثلة
استخدام الدالة ()mapIndexedNotNullTo مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًا من ستة أعداد باستخدام الدالة ()arrayOf، وتعرّف كائنًا من النوع MutableList<Int> باسم mutable، ثم تستخدم الدالة ()mapIndexedNotNullTo على array، مع تمرير mutable ودالة تعيد null إن كانت قيمة العنصر تخالف قيمة فهرسه أو تعيد العنصر نفسه، ثم تطبع mutable:
fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
val mutable: MutableList<Int> = mutableListOf()
array.mapIndexedNotNullTo (mutable) { a, b -> if (a==b) a else null }
println(mutable) // [0, 2, 5]
}
انظر أيضًا
mapIndexed(): تضيف إلى اللائحة المُمرّرة إليها ناتج تطبيق الدالةtransform()المُمرّرة إليها على عناصر المصفوفة أو المجموعة أو القاموس وفهارسها.map(): تعيد لائحة تضم ناتج تطبيق الدالةtransform()المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالةmap()على قاموس فستعيد لائحة تضم ناتج تطبيق الدالةtransform()على مداخل (entries) القاموس.
mapIndexedNotNull(): تعيد لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالةtransform()على عناصر المصفوفة أوالمجموعة التي استُدعيت عبرها وعلى فهارسها.