الفرق بين المراجعتين ل"Kotlin/collections/mapIndexedNotNull"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| (5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | + | تعيد الدالة <code>mapIndexedNotNull()</code> [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. | |
| − | تعيد الدالة<code>mapIndexedNotNull()</code> [[Kotlin/collections/List| | ||
| − | |||
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة<code>mapIndexedNotNull()</code> | + | يمكن استدعاء الدالة<code>mapIndexedNotNull()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin"> |
inline fun <T, R : Any> Array<out T>.mapIndexedNotNull( | inline fun <T, R : Any> Array<out T>.mapIndexedNotNull( | ||
transform: (index: Int, T) -> R? | transform: (index: Int, T) -> R? | ||
): List<R> | ): List<R> | ||
| − | + | ||
inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull( | inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull( | ||
transform: (index: Int, T) -> R? | transform: (index: Int, T) -> R? | ||
): List<R> | ): List<R> | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| − | == | + | |
| − | [[Kotlin/collections | + | == المعاملات == |
| + | |||
| + | === <code>transform</code> === | ||
| + | دالةٌ تطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر. | ||
| + | |||
| + | ==القيم المعادة== | ||
| + | تُعاد قائمةٌ تضم ناتج تطبيق الدالة <code>transform</code> المُمرّرة على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. | ||
==أمثلة== | ==أمثلة== | ||
| − | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()mapIndexedNotNull</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) |
| − | println(array.mapIndexedNotNull { a, b -> if (a==b) a else null }) // [0, 2, 5] | + | println(array.mapIndexedNotNull { a, b -> if (a == b) a else null }) // [0, 2, 5] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==انظر أيضًا== | |
| − | *<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>: | + | *الدالة <code>[[Kotlin/collections/mapIndexedNotNullTo|mapIndexedNotNullTo()]]</code>: تشبه هذه الدالة تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. |
| − | *<code>[[Kotlin/collections/ | + | *الدالة <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/mapNotNull|mapNotNull()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. | ||
| + | * الدالة <nowiki/>[[Kotlin/collections/filterIndexed|<code>filterIndexed()</code>]]: ترشِّح ترشِّح عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي تُعاد القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed-not-null.html الدالة mapIndexedNotNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed-not-null.html الدالة mapIndexedNotNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexedNotNull()</code> في Kotlin}}</noinclude> |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Collection]] | ||
المراجعة الحالية بتاريخ 08:24، 8 سبتمبر 2018
تعيد الدالة mapIndexedNotNull() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
البنية العامة
يمكن استدعاء الدالةmapIndexedNotNull() مع المصفوفات والمجموعات:
inline fun <T, R : Any> Array<out T>.mapIndexedNotNull(
transform: (index: Int, T) -> R?
): List<R>
inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull(
transform: (index: Int, T) -> R?
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
transform
دالةٌ تطبق على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر.
القيم المعادة
تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform المُمرّرة على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة المعطاة باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
أمثلة
تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()mapIndexedNotNull لجلب العناصر التي تتساوى قيمتها مع فهرسها من تلك المصفوفة:
fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
println(array.mapIndexedNotNull { a, b -> if (a == b) a else null }) // [0, 2, 5]
}
انظر أيضًا
- الدالة
mapIndexedNotNullTo(): تشبه هذه الدالة تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. - الدالة
mapIndexed(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. - الدالة
map(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معه. - الدالة
mapNotNull(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّةnullالتي تعيدها تلك الدالة. - الدالة
filterIndexed(): ترشِّح ترشِّح عناصر المصفوفة أو المجموعة المعطاة التي تُعاد القيمةtrueمعها عند تطبيق الدالةpredicate()المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()ثم تعيد بدورها قيمة منطقيَّة.