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

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

تطبق الدالةmapNotNullTo()‎ الدالة المُمررّة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج غير المعدومة (non-null) إلى المعامل الممرّر destination. وفي حال استدعاء الدالة mapNotNullTo()‎ على قاموس فستضيف النتائج غير المعدومة (non-null) لتطبيق الدالةtransform()‎ على مداخل (entries) القاموس إلى المعامل الممرّر destination.

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

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

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

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

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

يمكن استدعاء الدالةmapNotNullTo()‎ على القواميس:

inline fun <K, V, R : Any, C : MutableCollection<in R>> Map<out K, V>.mapNotNullTo(
    destination: C, 
    transform: (Entry<K, V>) -> R?
): C

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

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

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

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًة من ستة أعداد باستخدام الدالة ()arrayOf، وتعرّف كائنًا من النوع mapNotNullTo باسم mutable، ثم تستخدم الدالة ()mapNotNullTo على array، مع تمرير الكائن mutable ودالة تعيد null إن كانت قيمة أكبر من 2 أو تعيد العنصر نفسه، ثم تطبع mutable:

fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
val mutable: MutableList<Int> = mutableListOf()
    
array.mapNotNullTo (mutable) { a -> if (a > 2) a else null }
    
println(mutable)   // [4, 7, 5]
}

انظر أيضًا

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>mapNotNullTo()‎</code> في لغة Kotlin}}</noinclude>
-تطبق الدالة<code>mapNotNullTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى  ا<nowiki/>[[Kotlin/collections/List|لمعامل]]  الممرّر <code>destination</code>.
+تطبق الدالة<code>mapNotNullTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج غير المعدومة (non-null) إلى  ا<nowiki/>[[Kotlin/collections/List|لمعامل]]  الممرّر <code>destination</code>.  وفي حال استدعاء الدالة <code>mapNotNullTo()‎</code> على <nowiki/>[[Kotlin/Map|قاموس]] فستضيف النتائج غير المعدومة (non-null) لتطبيق الدالة<code>transform()‎</code> على مداخل (entries) <nowiki/>[[Kotlin/Map|القاموس]] إلى  ا<nowiki/>[[Kotlin/collections/List|لمعامل]]  الممرّر <code>destination</code>.
 ==البنية العامة==
 يمكن استدعاء الدالة<code>mapNotNullTo()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
-inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo(
+inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo(
      destination: C,
-     transform: (index: Int, T) -> R
+     transform: (T) -> R?
 ): C
-inline fun <R, C : MutableCollection<in R>> ByteArray.mapIndexedTo(
+</syntaxhighlight>يمكن استدعاء الدالة<code>mapNotNullTo()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
-    destination: C,
+inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo(
-    transform: (index: Int, Byte) -> R
-): C
-inline fun <R, C : MutableCollection<in R>> ShortArray.mapIndexedTo(
-    destination: C,
-    transform: (index: Int, Short) -> R
-): C
-inline fun <R, C : MutableCollection<in R>> IntArray.mapIndexedTo(
-    destination: C,
-    transform: (index: Int, Int) -> R
-): C
-inline fun <R, C : MutableCollection<in R>> LongArray.mapIndexedTo(
-    destination: C,
-    transform: (index: Int, Long) -> R
-): C
-inline fun <R, C : MutableCollection<in R>> FloatArray.mapIndexedTo(
-    destination: C,
-    transform: (index: Int, Float) -> R
-): C
-inline fun <R, C : MutableCollection<in R>> DoubleArray.mapIndexedTo(
      destination: C,
-     transform: (index: Int, Double) -> R
+     transform: (T) -> R?
 ): C
-inline fun <R, C : MutableCollection<in R>> BooleanArray.mapIndexedTo(
+</syntaxhighlight>يمكن استدعاء الدالة<code>mapNotNullTo()‎</code> على [[Kotlin/collections|القواميس]]:<syntaxhighlight lang="kotlin">
-    destination: C,
+inline fun <K, V, R : Any, C : MutableCollection<in R>> Map<out K, V>.mapNotNullTo(
-    transform: (index: Int, Boolean) -> R
-): C
-inline fun <R, C : MutableCollection<in R>> CharArray.mapIndexedTo(
-    destination: C,
-    transform: (index: Int, Char) -> R
-): C
-</syntaxhighlight>يمكن استدعاء الدالة<code>mapNotNullTo()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
-inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(
      destination: C,
-     transform: (index: Int, T) -> R
+     transform: (Entry<K, V>) -> R?
 ): C
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المٌعادة==
-الوسيط المُمرّر <code>destination</code> بعد إضافة نتائج تطبيق الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+الوسيط المُمرّر <code>destination</code> بعد إضافة النتائج غير المعدومة (non-null) لتطبيق الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/Map|القاموس]]<nowiki/>الذي استُدعيت عبره.
 ==أمثلة==
 ===استخدام الدالة <code>()mapNotNullTo</code> مع المصفوفات===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code>mapNotNullTo</code> باسم <code>mutable</code>، ثم تستخدم الدالة  <code>()mapIndexedTo</code> على <code>array</code><nowiki/>، مع تمرير الكائن  <code>mutable</code> ودالة تعيد مجموع قيمة العنصر  وقيمة فهرسه، ثم تطبع <code>mutable</code>:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code>mapNotNullTo</code> باسم <code>mutable</code>، ثم تستخدم الدالة  <code>()mapNotNullTo</code> على <code>array</code><nowiki/>، مع تمرير الكائن  <code>mutable</code> ودالة تعيد <code>null</code> إن كانت قيمة أكبر من <code>2</code> أو تعيد العنصر نفسه، ثم تطبع <code>mutable</code>:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val array = arrayOf(0, 2, 2, 4, 7, 5)
 val mutable: MutableList<Int> = mutableListOf()
-array.mapIndexedTo (mutable) { a, b -> a + b }
+array.mapNotNullTo (mutable) { a -> if (a > 2) a else null }
-println(mutable)   //  [0, 3, 4, 7, 11, 10]
+println(mutable)   // [4, 7, 5]
 }
 </syntaxhighlight>
@@ سطر 68: / سطر 40: @@
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed-to.html الدالة  mapNotNullTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-not-null-to.html الدالة  mapNotNullTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]