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

المراجعة الحالية بتاريخ 09:34، 8 سبتمبر 2018

تشبه الدالة mapIndexedNotNullTo()‎ الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

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

يمكن استدعاء الدالة mapIndexedNotNullTo()‎ مع المصفوفات والمجموعات:

inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapIndexedNotNullTo(
    destination: C, 
    transform: (index: Int, T) -> R?
): C

inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo(
    destination: C, 
    transform: (index: Int, T) -> R?
): C

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

المعاملات

`destination`

مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة transform.

`transform`

دالةٌ تطبق على كل عنصر من عناصر المصفوفات والمجموعات المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر.

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

يُعاد المعامل destination بعد إضافة ناتج تطبيق الدالة transform()‎ المُمرّرة على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة المعطاة باستثناء القيم العدميَّة null التي تعيدها تلك الدالة إليه.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()mapIndexedNotNullTo لجلب العناصر التي تتساوى قيمتها مع فهرسها من تلك المصفوفة وتخزينها في القائمة المتغيرة 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]
}

انظر أيضًا

الدالة mapIndexedNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
الدالة mapIndexed()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.
الدالة mapIndexedTo()‎: تشبه الدالة mapIndexed()‎ في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
الدالة map()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.
الدالة mapTo()‎: تشبه الدالة map()‎ باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
الدالة mapNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
الدالة mapNotNullTo()‎: تشبه هذه الدالة تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
الدالة filterIndexedTo()‎: تضيف إلى المجموعة المتغيرة destination المُمرَّر إليها عناصر المصفوفة أو المجموعة المعطاة التي أعيدت القيمة true مع كل عنصر منها عند تطبيق الدالة predicate()‎ المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة.

مصادر

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

@@ سطر 12: / سطر 12: @@
 ): C
 </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>destination</code> ===
+مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة <code>transform</code>.
+=== <code>transform</code> ===
+دالةٌ تطبق على كل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]] المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر.
 ==القيم المعادة==
 يُعاد المعامل <code>destination</code> بعد إضافة ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة إليه.
@@ سطر 38: / سطر 47: @@
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]