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

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

تشبه الدالة mapNotNullTo()‎ الدالة mapNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

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

يمكن استدعاء الدالة mapNotNullTo()‎ مع المصفوفات والمجموعات والخرائط:

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

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

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`

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

`transform`

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

أمثلة

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

انظر أيضًا

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

الدالة mapIndexedNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
الدالة mapIndexedNotNullTo()‎: تشبه الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
الدالة filterNotNull()‎: تعيد جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمة null.
الدالة filterNotNullTo()‎: تشبه الدالة filterNotNull()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>mapNotNullTo()‎</code> في لغة Kotlin}}</noinclude>
+تشبه الدالة <code>mapNotNullTo()‎</code> الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
-تطبق الدالة<code>mapNotNullTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى  ا<nowiki/>[[Kotlin/collections/List|لمعامل]]  الممرّر <code>destination</code>.
 ==البنية العامة==
-يمكن استدعاء الدالة<code>mapNotNullTo()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>mapNotNullTo()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]] والخرائط:<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(
+inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo(
      destination: C,
-     transform: (index: Int, Byte) -> R
+     transform: (T) -> R?
 ): C
-inline fun <R, C : MutableCollection<in R>> ShortArray.mapIndexedTo(
+inline fun <K, V, R : Any, C : MutableCollection<in R>> Map<out K, V>.mapNotNullTo(
      destination: C,
-     transform: (index: Int, Short) -> R
+     transform: (Entry<K, V>) -> 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
-): C
-inline fun <R, C : MutableCollection<in R>> BooleanArray.mapIndexedTo(
-    destination: C,
-    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>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>destination</code> ===
+[[Kotlin/collections/MutableCollection|مجموعة متغيرة]] تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة <code>transform</code>.
+=== <code>transform</code> ===
+دالةٌ تطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة. يمرر إليها العنصر وتعيد القيمة المقابلة له.
-</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
-): C
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-==القيم المٌعادة==
-الوسيط المُمرّر <code>destination</code> بعد إضافة نتائج تطبيق الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
 ==أمثلة==
-===استخدام الدالة <code>()mapNotNullTo</code> مع المصفوفات===
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()mapNotNullTo</code> لجلب قيم العناصر التي تزيد عن القيمة 2 فقط من تلك المصفوفة وتخزينها في القائمة المتغيرة <code>mutable</code>:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <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">
 fun main(args: Array<String>) {
-val array = arrayOf(0, 2, 2, 4, 7, 5)
+    val array = arrayOf(0, 2, 2, 4, 7, 5)
-val mutable: MutableList<Int> = mutableListOf()
+    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>
-===انظر أيضًا===
+==انظر أيضًا==
-*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
+*الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
-*<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/mapIndexed|mapIndexed()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
+*الدالة [[Kotlin/collections/map|<code>map()</code>]]‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
-* <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد لائحة تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
+*الدالة <code>[[Kotlin/collections/mapTo|mapTo()‎]]</code>: تشبه الدالة <code>[[Kotlin/collections/map|map()‎]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
+*الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
+*الدالة <code>[[Kotlin/collections/mapIndexedNotNullTo|mapIndexedNotNullTo()‎]]</code>: تشبه الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
+* الدالة <code>[[Kotlin/collections/filterNotNull|filterNotNull()‎]]</code>: تعيد جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة باستثناء تلك ذات القيمة <code>null</code>.
+* الدالة <code>[[Kotlin/collections/filterNotNullTo|filterNotNullTo()‎]]</code>: تشبه الدالة <code>[[Kotlin/collections/filterNotNull|filterNotNull()‎]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها.
 ==مصادر==
-*[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.]<noinclude>{{DISPLAYTITLE: الدالة <code>mapNotNullTo()‎</code> في Kotlin}}</noinclude>
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]