الفرق بين المراجعتين ل"Kotlin/collections/mapNotNullTo"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| سطر 1: | سطر 1: | ||
| − | + | تشبه الدالة <code>mapNotNullTo()</code> الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. | |
| − | |||
| − | |||
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة<code>mapNotNullTo()</code> | + | يمكن استدعاء الدالة <code>mapNotNullTo()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]] والخرائط:<syntaxhighlight lang="kotlin"> |
inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo( | inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo( | ||
destination: C, | destination: C, | ||
transform: (T) -> R? | transform: (T) -> R? | ||
): C | ): C | ||
| − | + | ||
inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo( | inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo( | ||
destination: C, | destination: C, | ||
transform: (T) -> R? | transform: (T) -> R? | ||
): C | ): C | ||
| − | + | ||
inline fun <K, V, R : Any, C : MutableCollection<in R>> Map<out K, V>.mapNotNullTo( | inline fun <K, V, R : Any, C : MutableCollection<in R>> Map<out K, V>.mapNotNullTo( | ||
destination: C, | destination: C, | ||
transform: (Entry<K, V>) -> R? | transform: (Entry<K, V>) -> R? | ||
): C | ): C | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| − | ==القيم | + | ==القيم المعادة== |
| − | + | يُعاد المعامل <code>destination</code> بعد إضافة ناتج تطبيق الدالة <code>transform()</code> المعطاة على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة أيضًا باستثناء القيم العدميَّة <code>null</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> | ||
fun main(args: Array<String>) { | 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.mapNotNullTo (mutable) { a -> if (a > 2) a else null } | + | array.mapNotNullTo(mutable) { a -> if (a > 2) a else null } |
| − | + | ||
| − | println(mutable) // [4, 7, 5] | + | println(mutable) // [4, 7, 5] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==انظر أيضًا== | |
| − | *<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</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>: تعيد لائحة تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها. | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-not-null-to.html الدالة | + | *[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]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 06:24، 25 يوليو 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() المعطاة على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة أيضًا باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
أمثلة
تعرف الشيفرة الآتية مصفوفة باسم 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]
}
انظر أيضًا
- الدالة
mapIndexed(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. - الدالة
map(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.
mapIndexedNotNull(): تعيد لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالةtransform()على عناصر المصفوفة أوالمجموعة التي استُدعيت عبرها وعلى فهارسها.