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

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

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

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

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

inline fun <T, R : Any> Array<out T>.mapNotNull(
    transform: (T) -> R?
): List<R>

inline fun <T, R : Any> Iterable<T>.mapNotNull(
    transform: (T) -> R?
): List<R>

inline fun <K, V, R : Any> Map<out K, V>.mapNotNull(
    transform: (Entry<K, V>) -> R?
): List<R>

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

المعاملات

`transform`

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

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

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

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستعمل الدالة ()mapNotNull لجلب قيم العناصر التي تزيد عن القيمة 2 فقط من تلك المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(0, 2, 2, 4, 7, 5)

    println(array.mapNotNull { a -> if (a > 2) a else null }) // [4, 7, 5]
}

انظر أيضًا

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

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

مصادر

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

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