عرض مصدر Kotlin/kotlin.text/mapIndexedNotNull

<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.mapIndexedNotNull()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>mapIndexedNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
==البنية العامة==
<syntaxhighlight lang="kotlin">
inline fun <R : Any> CharSequence.mapIndexedNotNull(
    transform: (index: Int, Char) -> R?
): List<R>
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>transform</code> ===
دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف.

==القيم المعادة==
تُعاد قائمةٌ تضم ناتج تطبيق الدالة <code>transform‎</code> المُمرّرة على فهرس وقيمة كل عنصر من عناصر محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
==أمثلة==
مثالٌ على استعمال الدالة <code>mapIndexedNotNull()‎</code>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val str = "Hsoub Wiki"

    print(str.mapIndexedNotNull { index, char -> if (index < 5) index + char.toInt() else null })
    // [72, 116, 113, 120, 102]
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNullTo|mapIndexedNotNullTo()‎]]</code>: تشبه الدالة <code>mapIndexedNotNull()‎</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
*الدالة <code>[[Kotlin/kotlin.text/map|map()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
*الدالة <code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
*الدالة <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
* الدالة <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]‎</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-indexed-not-null.html صفحة الدالة CharSequence.mapIndexedNotNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin CharSequence]]