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

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

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

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

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

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

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

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

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

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

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

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

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

أمثلة

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

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

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]
}

انظر أيضًا

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>mapNotNull()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<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/collections/List|لائحة]] تضم النتائج غير المعدومة (non-null) لتطبيق الدالة <code>transform()‎</code> المُمرّرة على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>mapNotNull()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم النتائج غير المعدومة (non-null) لتطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
 ==البنية العامة==
 يمكن استدعاء الدالة<code>mapNotNull()‎</code> على [[Kotlin/Array|المصفوفات]].<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> Iterable<T>.map(
+inline fun <T, R : Any> Iterable<T>.mapNotNull(
-     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)]].
 ==القيم المٌعادة==
-تعيد الدالة<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|القاموس]].
+[[Kotlin/collections/List|لائحة]] تضم النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> المُمرّرة على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت الدالة<code>mapNotNull()‎</code> عبرها، وفي حال استدعاء الدالة <code>mapNotNull()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
 ==أمثلة==
-===استخدام الدالة <code>()mapNotNull</code> مع القواميس===
+===استخدام الدالة <code>()mapNotNull</code> مع المصفوفات===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Map|قاموسًا]] باسم <code>m</code>مكونًا من ثلاثة أزواج باستخدام الدالة <code>()mapNotNull</code>، ثم تُعرّف الدالة <code>()func</code>، ثم تستخدم الدالة <code>()map</code> بتمرير <code>()func</code> كمعامل<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>  باسم <code>array</code>مكونًة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>،  ثم تستدعي الدالة <code>()mapNotNull</code> عبر <code>array</code>  بتمرير  دالة تعيد العنصر الممرر إليها إن كان أكبر من <code>2</code> أو تعيد <code>null</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(array.mapNotNull { a -> if (a > 2) a else null }) // [4, 7, 5]
-println(m.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
 }
 </syntaxhighlight>
 ===انظر أيضًا===
-*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
+* <code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى اللائحة المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القاموسوفهارسها.
+* <code>[[Kotlin/collections/map|map()]]</code>‎: تعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+* <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد لائحة تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
 ==مصادر==
-*[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.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]